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PREFACE 



This manual describes the features and operation of the SORT utility 
program under TRAX on the PDP-11. Chapter 1 describes the SORT 
program, its operation and environment. Chapter 2 is an operator's 
guide for running SORT. Chapter 3 is a reference for those who write 
the instructions for the SORT program. Chapter 4 describes error 
conditions, and Chapter 5 describes the use of files in SORT. 

Appendix A lists the ASCII character set and a subset of the EBCDIC 
code. Table A-l lists the ASCII code values in ascending octal 
sequence with the corresponding EBCDIC values. This is useful for 
comparing values when requesting a modified ASCII sorting sequence or 
when defining forced key fields. Table A-2 lists the EBCDIC subset 
used when you request an EBCDIC sorting sequence. The EBCDIC values 
are in ascending order with the corresponding ASCII values. 

Appendix B contains two tables to help you determine the digit and 
zone values of printable characters. For example, the characters B, 
K, and S have an equal absolute digit value of 2; however, the 
"eleven" punch denotes a negative value. The digit values of J 
through R are negative (-) 1 through 9. 

Appendix C gives examples of SORT applications. 

Appendix D lists RMS status codes. 

A glossary is included to define terminology used in this manual. 



CHAPTER 1 
INTRODUCTION TO SORT 



The SORT utility program allows you to read any input file, sort the 
contents, and write out the sorted data onto an output file. The 
sorting sequence is determined by control fields, or key fields, 
within the data itself. If you do not wish to sort your data base, 
you can still use SORT to extract key information, sort that 
information, and store the sorted information on a permanent file. 
You can later use that file to access your data base in the order of 
the key information on the sorted file. The contents of the sorted 
file may be entire records, key fields, or record indices relative to 
the position of each record within the file (the first record on the 
data base is record 1, the second, 2, etc.). 

SORT provides two sorting techniques: 

1. Record Sort (SORTR) 

Record Sort produces a reordered file by using the entire 
contents of each record as the record key. A record sort can 
be used on any acceptable input device and can process any 
valid RMS (Record Management Services) format. 

2. Tag Sort (SORTT) 

Tag Sort produces a reordered file by sorting only the record 
keys. SORT then randomly reaccesses the input file to create 
a resequenced output file according to those record keys. 
The tag sort method conserves temporary storage, but can only 
accept input files residing on disk. 

The SORT utility program may be controlled by a command string and an 
optional specification file. There is a simple format for each. If 
your SORT application does not require that records be restructured or 
that only a subset of the input file be sorted, then you need only a 
command string to control SORT. 

SORT can handle any RMS-valid file organization. Different file 
organizations are distinguished by the ordering of the records they 
contain and the way they handle the retrieval process. 

The order of the records in a sequential file is determined by the 
order in which the records are read from the file. The first record 
in the file is the first record read out, regardless of whether the 
records are written to the file in some sorted order or not. 

A relative file consists of record areas that are identified by 
relative record numbers. The first record area in the file is record 
number 1, the second is 2, etc., much the same as an apartment house 
where the first apartment is 1, and so forth. But, as in an apartment 
house, if you want the record that is in the twelfth record area, for 
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instance, you must ask for record number 12, even though there may not 
be records in areas 1 through 11. Relative files can reside only on 
disk . 

An indexed file contains prologue information, one or more indices, 
and the data records themselves. To retrieve information, you ask for 
the proper record by primary or alternate key. The system looks up 
the key in the appropriate index and retrieves the record using the 
record pointer associated with the key. Indexed files can reside only 
on disk. 

Table 1-1 shows the devices that you may use to supply data to SORT. 
Data may be stored in binary, ASCII, or EBCDIC form. 



1.1 DATA FILES 

SORT may accept a file from any one of the peripheral devices 
available in the system configuration: 

1. Disk unit 

2. Magtape unit 

3. Support Environment terminal 

A record is usually divided into several logical areas called data 
fields. The data in each field may or may not be relevant to SORT. 
Each field may be interpreted as a record identifier, key data, or 
general data related to the logical content of the record and not 
relevant to the sorting process. SORT uses record identifiers to 
distinguish the various types of records in a file. SORT uses the key 
fields in each record to reorder an input file. Any other data field 
in a record may be retained in the output file or ignored by SORT. 

Figure 1-1 shows three different types of input records, each with a 
different format. The record identifiers are the letters in position 
1: S means Sales record, means Order record, and R means Restock 
record. In this case, the keys chosen for sorting the Sales record 
types are the "item number code" in positions 2 to 7 , and the "number 
of items sold" in positions 8 to 13. The "total amount of sale" is an 
example of a data field not relevant to the sorting process. 
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Table 1-1 

Selecting the Sorting Process and Devices 
that Best Suit the Processing Environment 



SORTING 


INPUT 


OUTPUT 


WORK 


TECHNIQUE 


FILE 


FILE 


FILE 




Disk 


Disk 


Disk (3-8 files) 


(Record Sort) 


Magtape 


Magtape* 






Terminal 


Terminal 




SORTT 


Disk 


Disk 




(Tag Sort) 


Magtape 


Magtape* 








Printer 








Terminal 





* Provided records are at least 18 bytes long. Magtape must be in 
ANSI format. 



DATA FIELD 



2 3 4 5 6 



9 10 11 12 13 14 15 16 



6 19 30 21 22 23 24 25 26 27 28 29 30 II 3)2 33 34 35 36 37 36 39 40 



S I TEMNOOUANTYUCPRICETOTLSALECUSTNOORDDAT 



ITEM NUMBER UNIT PRICE 

NUMBER OF ITEMS CODE PER 

CODE SOLD UNIT 



TOTAL 
AMOUNT 
OF SALE 



CUSTOMER 
NO. 
COOE 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 



DESCRIPTION 
OF 
ITEM 



ITEM 
NO. 
CODE 



PRICE 
OF 
ITEM 



NUMBER 
OF ITEMS 
ORDERED 



PURCHASE 
ORDER 



12 13 '4 'S 16 17 16 19 20 ?! 22 23 24 25 26 27 28 29 30 31 32 



ITEM UNIT COST 

NO. CODE PER 

CODE UNIT 



MINIMUM 
STOCK 
QUANTITY 



PRESENT 

AMT. 
OF STOCK 



DATE 

OF 
SALE 



Figure 1-1 Sample Record Types 

If you request a sort in ascending order on the sales records 
illustrated above, the sort is based on the item number code first and 
then on the number of each item sold within that item number. In 
order of decreasing significance, the keys are: 

1. Item number 

2. Number of items sold 



The output file contains all sales records in the order shown in Table 
1-2. Data fields other than those you use for keys, e.g., 
salesperson's code, may be in any order. 
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Table 1-2 
Sorted Output File 



First Key: Item Number 


Second Key:Quantity 


lowest item no. 
lowest item no. 


lowest quantity 
next higher quantity 


lowest item no. 
next higher item no. 
next higher item no. 


highest quantity 
lowest quantity 
next higher quantity 


next higher item no. 
highest item no. 
highest item no. 


highest quantity 
lowest quantity 
next higher quantity 


highest item no. 


highest quantity 



1.2 COMMAND STRING AND SPECIFICATION FILE 

You invoke the SORT program by entering a command string. The command 
string has three functions: 

1. To reference devices in the system for each file in the 
current sort. 

2. To specify switches that define file parameters used in the 
sorting process. 

3. To reference a specification file or to specify other 
switches to control the sort. 

Several command string switches define the sorting process parameters. 
One switch describes record formats and the maximum record size. 
Another delimits the internal work files. Others provide detailed 
file information to RMS. 

Normally, you direct the sort with a specification file. Or, you may 
use two additional switches instead of a specification file to control 
a sort. One switch specifies the sorting process option; the other 
identifies the key fields. The use of these switches is limited to 
sorting an input file of uniform format: 
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1. The key fields must reside in the same location in every 
record of the input file. 



2. The file must contain only the records to be included in the 
sort. The figure below illustrates a general sort that would 
require only a command string and switches. 




The specification file is the supplement to the command string, which 
provides the basis for controlling and directing the sorting process. 

The specification file provides the following controlling features: 

1. Record Selection 




You can include or omit any records from the sorting process. 
The output file will contain only the records that you 
specify. 
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2. Alternate Collating Sequence 




If necessary, you can specify an alternate collating 
sequence. The normal sequence is that implied in ASCII code. 
One alternate choice is EBCDIC values. The other is an 
individual alternate collating sequence (ALTSEQ) . An ALTSEQ 
can be used to change the ASCII values of the normal 
sequence. It applies to all the alphanumeric key data in the 
records, but only during the actual sorting process. The 
output record remains unchanged. 



3. Forced Keys 




An ALTSEQ applies to all positions of the key. Forced keys 
allow you to specify an alternate sequence for particular 
positions within the key. You can specify an alternate 
sequence by substituting a lower-valued character, such as 
the slash (/) in the example above. Since the slash comes 
before 0, the 300-series records in the example are brought 
to the front of the file. Notice that the records so treated 
are in sequence and in front of the rest of the sorted file. 
The net effect is that of two sorted files, one behind the 
other . 
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4. Input Format Variation 



INPUT FORMAT VARIATION 



If the input file contains records with several different 
formats, you can identify those records by type so that they 
may be properly handled. 

In the example above, A and N are record identifiers. 



5. Output Format Variation 



OUTPUT FORMAT VARIATION 



You can change the format of the data file during the sort, 
but you cannot change the contents of any given data item. 



1.3 OPERATION OF SORT 

The SORT program consists of two basic parts: a control program and a 
subroutine package called SORTS. The control program directs the 
overall processing. SORTS serves as a collection of subroutines that 
the control program uses during its processing. 

There are three phases of operation in the SORT control program.* In 
the first phase, SORT reads the command string, decodes, and stores 
the switch values and the specification file, if present. Any errors 
in the command string or specification file are reported at this 
point. 



* Each phase of operation corresponds to an overlay in the SORT 
program structure. 
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The second phase begins the pre-sort operation. The control program 
is called to open and read the input file and establish the keys. 
Then the SORTS subroutine begins the initial sorting process. At this 
point, the amount of available internal storage space becomes 
important to the efficiency of the sort. If that space is not 
sufficient to hold all the records, SORT builds strings of sorted 
records and transfers them to scratch files on bulk storage devices. 
In order to merge these files and complete the sort, space for at 
least three scratch files must be available. The SORT program 
normally provides for a maximum of eight scratch files. Either a 
switch in the command string or the amount of available internal work 
space can reduce the number of scratch files used. 

The merge phase rebuilds the intermediate scratch files into a merged 
file. Another subroutine reads the records in the proper sequence. 
The records are then written into the output file. If there are no 
scratch files to merge because main memory was sufficient to hold all 
the records, the sorted records are written directly into the output 
file. After the last record is written, the control program cleans up 
the scratch files and returns to the first phase; SORT is then ready 
to accept another job. 



1.4 SORT PROCESSING OPTIONS 

There are two SORT processes: Record Sort and Tag Sort. You can 
specify the SORT process in the specification file or with a switch in 
the command string. The default process is the Record Sort. Each 
process has its particular input requirements, processing methods, and 
resultant output files. 



1.4.1 Record Sort (SORTR) 



The Record Sort (SORTR) outputs all specified record data in a sorted 
sequence. Each record is kept intact throughout the entire sorting 
process. Since it moves the whole record, SORTR is relatively slow 
and may require considerable main memory or external storage work 
space for large files. 



NOTE 

Records can be FIXED, STREAM ASCII, or 
VARIABLE length in any valid RMS (Record 
Management Services) format. The size 
of the records on a fixed length format 
file is determined when the file is 
created. Variable length records carry 
a count along with them that specifies 
their length. This length data is used 
by the RMS routines and is transparent 
to SORT. 
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Table 1-3 
Sorting Process Options 



Type of 

-Z Er w j_ 


Type of 

J. Er w 


Record Size 






SORT 


File 


and Format 


Device 


Speed 


SORTR 


Input 


any 


Any appropriate device 


Slow 


(RECORD 


and 




including: disk, 




SORT) 


Output 




magtape* 




SORTT 


Input 


any 


disk 


Slow for 


(TAG 








large 


SORT) 








files , 




Output 


any 


any appropriate device 


large keys 








(including magtape*) 





* Magtape labels are ANSI standard. 



1.4.2 Tag Sort (SORTT) 



The Tag Sort (SORTT) produces the same kind of output file as SORTR, 
but it only handles record pointers and key fields. Since SORTT moves 
a smaller amount of data than SORTR, SORTT usually performs a faster 
sort than SORTR. The input file must be randomly re-accessed to 
create the entire output file, which may be a lengthy process for 
large files. 
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USING THE SORT COMMAND 



The SORT utility is installed as part of the TRAX Support Environment. 
It can be invoked from any TRAX support terminal by using the SORT 
command string. This chapter describes the available forms of the 
SORT command. See Chapter 3 of this manual for details about specific 
properties of the SORT utility. 



2.1 THE SORT COMMAND STRING 

Two forms of the SORT command are possible. The standard form uses 
the syntax: 

>SORT [/Qualifier (s) ] Input-Filespec [/file-qualifier (s) ] 

Qualifiers and File-qualifiers are discussed in Chapter 3. They are 
used to specify the type of sort and the attributes of the file being 
sorted, as well as passing control information to the SORT utility. 

A second form of the SORT command allows for interactive prompting of 
the input file specifications: 

>SORT [/Qualifier (s) ] 

FILE?Input Filespec [/file-qualifier (s) ] 

To illustrate the SORT command string, consider a payroll program 
example. The payroll program has generated a disk-based file of 
80-character fixed-length records called WAGES.DAT which contains the 
Social Security Account Number along with wage and tax data for each 
employee of a firm. Prior to reporting wages to the Social Security 
Administration, you must verify that the file is in ascending SSAN 
sequence. The following command string will sort the file WAGES.DAT 
on a nine-character SSAN key beginning in character position one of 
the wage record. 

> SORT/KEYS: (1 . 9) /PROCESS : RECORD WAGES .DAT/FORMAT: FIXED: 80 

The qualifiers /KEYS and /PROCESS, as well as the file-qualifier 
/FORMAT are explained in detail in Chapter 3. 

After you enter the SORT command string, the SORT utility begins 
processing. Any errors detected in the command string or 
specification file are printed immediately on your support terminal. 
At the end of a successful run, SORT returns the following messages: 

SRT — M: ELAPSED REAL TIME: hh:mm:ss 
SRT — M: TOTAL RECORDS SORTED: nn 
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This message reports the wall-clock time necessary to perform the sort 
and the number of records in the output file. You are then returned 
to the TRAX operating system where you may enter additional SORT 
command strings, or go on to some other operation. 



2.1.1 Multiple Line Input 

In the event that your SORT command string becomes too long to fit in 
a single line, division of the command string is possible. Simply use 
a hyphen (-) as the last printing character of a line, enter a 
carriage return, and continue your command string on the next input 
line. You should avoid splitting qualifiers and their arguments over 
more than one line. 

Referring again to the example of the wages file sort, you could 
divide that command string as follows: 

> SORT/KEYS (1. 9) - 
DCL>/PROCESS: RECORD - 
DCL>/WAGES . DAT/FORMAT: FIXED : 80 

DCL> is the prompt of the DEC Command Language interpreter, which 
decodes your command string and passes this information to the 
operating system. Note that the second line PROCESS : RECORD - has a 
space after the word RECORD. This space is required to distinguish 
the command qualifiers from the input file specification and should be 
present at all times. You may also subdivide indirect command file 
input strings in the manner described above. 



2.2 INDIRECT COMMAND FILES 

The TRAX Support Environment allows you to create indirect command 
files which reside on your system device and are made up of command 
string input. With the SORT command, this facility allows you to 
create a command file which can then be executed at regular intervals 
for certain recurring types of processing. In the case of the wages 
example cited earlier in this chapter, you might create a file 
WAGSRT.CMD which contains the following information: 

SORT/KEYS : (1.9) /PROCESS : RECORD WAGES . DAT/FORMAT : FIXED : 80 

You execute this indirect command file by typing the following string: 

>@WAGSRT 

The file WAGSRT.CMD is then retrieved by the indirect command file 
processor and decoded to invoke the SORT command with the qualifiers 
you have specified. 



2.3 RMS-11 FILE SPECIFICATION INFORMATION 

A TRAX file specification conforms to standard RMS-11 conventions. It 
has the following form: 

device: [ufd] filename . filetype ; version 
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where : 



device is the name of the physical device on which the volume 
containing the desired file is mounted. The name 
consists of two ASCII characters followed by a 1- or 
2-digit octal unit number and a colon(:); for example, 
LPO: or DBl : . A logical device name may also be used. 



Dev: 


Device 


SY: 


system disk, default device 


TI: 


user's terminal 


TTn: 


Support Environment Terminal 


LPn : * 


line printer 


DBn: 


RP04/05/06 disk 


DMn: 


RK06/07 disk 


DRn: 


RM02/03 


MMn: 


magnetic tape (TU45/TE16) 



* n specifies the device unit number; if n is not 
specified, n is assumed to be 0. 

[ufd] is the user file directory specification consisting of 

two octal numbers in the range of 1 through 377 
(octal) . These numbers must be enclosed in brackets 
and separated by a comma and must be in the following 
format: 

[group, member ] 

For example, member 225 of group 300 would use the 
following entry: 

[300,225] 

filename is the name of the desired file. The file name can be 
from one to nine alphanumeric characters; for example, 
BILLRTN. You must always specify the file name. There 
is no default specification for this component. 
Failure to specify the file name causes an error to be 
generated . 

filetype is the 3-character file type identification. Separate 
the file name and filetype with a period (.). Files 
with the same name but different functions are 
distinguished from one another by the filetype; for 
example, BILL . TSK and BILL. OBJ might be the task file 
and the object file, respectively, for the program 
BILL. You may omit the file type, but you should avoid 
this practice when dealing with system programs which 
generally assume a default filetype for various 
operations. The wild card (*) specifier may be used in 
place of a file type. The action specified will be 
applied to all file types associated with a given file 
name or wild card file name. (e.g., *.* specifies the 
current version of all files in the user file 
directory. ) 
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version is the octal version number of the file in the range 1 
through 77777 (octal) . Separate the extension and 
version by a semicolon (;). Various versions of the 
same file are distinguished from each other by the 
version number; for example, BLL.OBJ;l and BILL.0BJ;2 
are successive versions of the same file. The version 
number may be omitted, in which case the current 
(highest-numbered) version is assumed. To act upon all 
versions of a file, you can use the wild card (*) 
specification. 

The device, user file directory code, filetype, and the version 
specification are all optional. 

Table 2-1 lists the default assumptions applied to missing components 
of a file specification. Table 2-2 lists the filetypes assumed by 
TRAX system software. 



Table 2-1 



Item 


Default 


device 

[ufd] 

version 


user's current default device 
user's current default [ufd] 

for an input file, the default version number is 
the existing version with the highest (octal) 
number for that file. 

for an output file, the default is calculated as 
one greater than the highest existing version 
number for that file. 



Table 2-2 



File Contents 


Default 


Description 


Filetype 


task image file 


. TSK 


memory allocation file 


. MAP 


symbol definition file 


.STB 


object module 


.OBJ 


object module library file 


. OLB 


overlay description file 


. ODL 


indirect command file 


. CMD 


COBOL source text file 


. CBL 


BASIC-PLUS-2 source file 


. B2S 


MACRO-11 source file 


. MAC 
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SORT EXECUTION OPTIONS 



3 . 1 SWITCHES 

SORT switches describe the input and output files and allow you to 

change SORT defaults, such as the number of scratch files used. All 

numeric switch values are decimal, not octal. All switches are valid 

for both input and output files unless otherwise noted. Table 3-1 

summarizes the switches and other pertinent information for your 
convenience . 



3.1.1 ALLOCATION (/AL:n) 

The ALLOCATION switch is valid for the output file only. You can use 
this switch to specify the initial space allocation for the output 
file. Legal values range from to 65,535. If you do not use this 
switch, the output file allocation defaults to the input file size for 
the record and tag sort processes. 



3.1.2 BLOCKSIZE (/BL:n) 

The BLOCKSIZE switch is valid for magtape files only and is used to 
specify a nonstandard magtape blocksize. If this switch is not used, 
the blocksize defaults to the standard 512-byte block. 



3.1.3 BUCKETSIZE (/BU:n) 

The BUCKETSIZE switch specifies the RMS bucket size (the number of 
512^byte blocks per bucket) . Please note that the size of the block 
is the standard 512 bytes even if the BLOCKSIZE switch is used. The 
default value of this switch depends on the organization of the input 
file. If the input and output files are of the same organization, the 
default for the output file is the input file value. If the input 
files differ in organization or the default is required for the input 
file, the default value is 1. 
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Table 3-1 
Switch Summary 



Switch Name 


Code 


Default Value 


Validity 


ALLOCATION 


/AL:n 


See Section 3.1.1 


Output 


BLOCKS I ZE 


/BL:n 


512 bytes 


Both 

(magtape) 


BUCKETSIZE 


/BU:n 


Input file or 1 


Output 


CONTIGUOUS 


/CO 


Non- contiguous 


Output 


nFVTPF 

1~/XJ V -L V i_j 


/DF - v 


SY : 


T nnn f* 

.L 1 Ik* \JL 


FILES 


/FI : n 


5 


Both 


FORMAT 


/FO : x : n 


(qe»pi Section 3 17) 


Both 


INDEXED SEOUENTIAL 


/IN : x 


\ 1^ J— Va/Va/ U11W W / 


I nput 


KEY 


/'KF • ahtn n 


P M *F "i t" doc; i fi nn 

of field, length of 
field 


Input 


OUTPUT 


/OU: f ilespec 


Input file 


Output 


PROCESS 


/PR:x 


R (record sort) 


Input 


RELATIVE 


/RE 


(See footnote) 


Output 


SEQUENTIAL 


/SE 


(See footnote) 


Output 


SIZE 


/SI:n 


(See Section 3.1.14) 


Output 



* The default for input files is the type of file present at OPEN 
time. 



The default for output files is SEQUENTIAL. The output record format 
will default to the characteristics of the input file unless you use 
STREAM ASCII input record format. STREAM ASCII will produce a 
VARIABLE output record format. 

Default record sizes are the size of the input record. 



3.1.4 CONTIGUOUS (/CO) 

The CONTIGUOUS switch is valid for 
that the output file will be conti 
each successive block assigned to a 
between its logical predecessor 
filler or extraneous material separ 
non-contiguous . 



output files only. It specifies 
guously allocated. This means that 
file will be physically located 
and its logical successor with no 
ating the blocks. The default is 



3.1.5 DEVICE (/DE:x) 

The DEVICE switch lets you specify which device you want to be 
associated with the scratch files. This switch overrides any device 
specification from task build options. The parameter x is any valid 
1- to 4-character device name with the colon that normally follows 
that name omitted (e.g. DB3) . 
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3.1.6 FILES (/PI:n) 

The FILES switch specifies the maximum number of intermediate scratch 
files. The default is 5. 



3.1.7 FORMAT (/FO:x:n) 

The FORMAT switch specifies the record format (x) and the maximum 
record size (n) in a file. The record format x may take the following 
values : 

FIXED, 
STREAM , 
VARIABLE, or 
UNKNOWN 

Record format values may be truncated to the first letter. The 
maximum record size n is the exact record size in bytes for FIXED 
length records. For the other formats, n is the size in bytes of the 
largest record present. The record size is required only on input. 

This switch must be present in input files even if the format is 
UNKNOWN. The default of the record format (x) is VARIABLE. The 
record format on output can be used to override the input record 
format. For the default of n, see the footnote of Table 3-1. 



3.1.8 INDEXED SEQUENTIAL (/IN:X) 

The INDEXED SEQUENTIAL switch specifies the INDEXED SEQUENTIAL file 
organization. For default values, see the footnote of Table 3-1. X 
specifies the number of keys (no default) . This switch is valid on 
input only. 



3.1.9 KEY (/KErabm.n) 

The KEY switch is the most important switch in the SORT parameters. 
It tells SORT which fields are to control the sequence of the output 
file. You can specify more than one key field (up to 10) if you 
separate each description from the next with a colon. Here is an 
example of two key fields: 

/KE:BN1.6:C8.2 

The field description sequence in the basic format above is abm.n 
which breaks down as follows: 

a specifies the way in which the data is to be handled. 

If it is omitted, the default value is C as described 
below. But first, if you have not used SORT before, 
take a look at Appendix B and become acquainted with 
the concepts of zones and digits. 

Here are the legal values for the data handling 
parameter and their interpretations: 

B two's complement binary 

C alphanumeric 
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D 1. if the characters are alphabetic, numeric with the 
sign superimposed over the units digit, or contain 
slashes (/) , use the value of the digits group (see 
Table B-l). Here are two examples and their values: 

A2CD5 = (+)12345 A/47J = (-J11471 

If the characters represent a standard number, such as 
12, -35, 42.98, or -0.76E+3, convert the number to 
binary for storage or evaluation 

F 2- or 4-word floating point binary 

I same as D, but with the sign leading and separate, so 
that the first byte of the field is a + or - 

J same as I but with the sign trailing and separate 

K same as D but with the sign leading and overpunched 
(54321, for instance, if positive, would come out as 
5432A. The negative of 54321 would be 5432J.) 

P packed decimal format 

Z ASCII zone (see Table B-2) 

b defines the general sort order. The default is N 

(ascending order) . 

N ascending order 

opposite, or descending, order 

m is a decimal number giving the first byte of the key 

field. Number from the first byte of the record which 
is byte 1. This item must be present. 

n is a decimal number giving the length of the key field 

in bytes. This item must be present. 



3.1.10 OUTPUT (/OUrfilespec) 

The OUTPUT switch specifies the file that will receive the sorted 
records. Default is the input file. 

3.1.11 PROCESS (/PR:x) 

The PROCESS switch specifies the type of sorting process to use. 
Legal values are: 

R - RECORD (the default) 
T - TAG 

3.1.12 RELATIVE (/RE) 

The RELATIVE switch, for output only, specifies RELATIVE file 
organization. For defaults, see the footnote of Table 3-1. 
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3.1.13 SEQUENTIAL (/SE) 



The SEQUENTIAL switch, for output only, specifies SEQUENTIAL 
organization. For defaults, see the footnote of Table 3-1. 



file 



3.1.14 SIZE (/SI:n) 

The SIZE switch specifies the size of the retrieval window. The range 
and default for the switch are determined by your system manager. 



3.2 THE SPECIFICATION FILE 

The specification file offers a variety of controls for the sorting 
process. These controls are entered in a format consisting of up to 
three types of records or lines in the specification file; a fourth 
type may be used if nonstandard collation is required. Figure 3-1 
shows two possible arrangements of the specification file whose 
elements are explained below. 



RECORD TYPE 



RECORD TYPE 



RECORD TYPE 



J RECORD TYPE 
ALTSEO 



I — 1 



A- FIELD 
J SPECIFICATIONS 



■ RECORD TYPE 
SPECIFICATION 



/ — FIELD 
'SPECIFICATIONS 



RECORD TYPE 
SPECIFICATIONS 



FIELD 
SPECIFICATIONS 



1 



-RECORD TYPE 
SPECIFICATION 



ALTERNATE COLLATING 

--I SEQUENCE RECORDS 

-HEADER RECORD 



-FIELD 

SPECIFICATIONS 



-ALTERNATE COLLATING 
SEQUENCE RECORDS 



■HEADER RECORD 



With Record Type Specifications 



Without Record Type Specifications 



Figure 3-1 Specification File Format 
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1. The Header 

The first record in a specification file must be the Header. 
The header tells the SORT program: 

• the kind of sorting process to be used, 

• the key field and output record size, 

• whether an alternate collating sequence is to be used, 
and 

• whether the key fields are to be stripped from the 
output. There is only one Header for each SORT 
execution . 

2. ALTSEQ Records 

If you use an alternate collating sequence, ALTSEQ records 
follow the header. ALTSEQ records allow you to change the 
order in which a character or characters is sorted. You can 
use these records to: 

1. Move certain records to the front or back of a file 

2. Group them in one place within the file 

3. Change the order in which records appear in a given 
sequence within the file 

3. Record Type Specifications 

If you do not use an alternate collating sequence, the next 
type of record or line in the specification file is record 
type specifications. They control record selection and allow 
SORT to work with variable record formats. If all records 
have an identical format (or the format is not important) and 
all are to be included in the output file, the record type 
specification may be omitted. 

4. Field Specifications 

If record type specifications appear, each is followed by any 
applicable field specifications. If not, the field 
specifications follow the header (behind any ALTSEQs) . The 
two kinds of field specifications are key field 
specifications and data field specifications. Key field 
specifications define and locate each key. They are listed 
in order of decreasing significance. Data field 
specifications define and locate all the data fields to be 
written to the output ^file. The data will appear in the same 
order in the output file as the data field specifications. 

Key field specifications appear first in the specification 
file and are followed by any data field specifications. 

The format of each type of specification record is fixed. 
The SORT specification form, is shown in Figure 3-2. The 
following entries are common to all three types of 
specification file lines. 
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Column Entry 
1-2 Page number 



Notes 

Required only when different 
types of records are to be 
described. A separate page, 
numbered in ascending sequence, 
should be used for each record 
type and its corresponding Field 
Specifications. Only the first 
page has a header specification. 



3-5 Line number Depicting line sequence. If 

column 5 is blank, is assumed. 
Thus a digit entry in this 
column can be used to identify 
later line insertions. 

6 Specification Type H, I, 0, or F as shown below 

40, etc. Comments Ignored by SORT processing 



EQUIPMENT 
CORPORATION 



Date . 
Progra 



SORT SPECIFICATIONS 

HEADER SPECIFICATION 



ED 



75 76 77 78 79 



Mode of Processing 



SORTR 
SORTT 
SORTA 
SORTI 

S 9 10 II 



Length of 
Key Fields 



13 ■< IS 16 II 



SORTR, T 



IProgram Idenlif.c 



SI S2 S3 S4 SS S6 SI S8 S9 60 61 62 63 64 66 66 61 68 69 70 71 72 73 1 



H SORT 



RECORD TYPE SPECIFICATION 



Line 
3 4 5 


|» Type I/O | 


o 
< 


I- C/Z/D/P/B/F | 


Factor 1 


EQ 
Nb 
GT 
GE 
LT 
LE 

17 18 


Factor 2 


Record Name j 

40 41 4? A3 44 45 46 47^48 49 SO SI 5? S3 54 SS 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 U )2 73 74 


Field Location 




•a Con 


stant 






Field Location ~™j 




From 
9 10 11 12 


To 
13 14 IS 16 


20 21 22 23 


To | 

2. 2S 26 


?•) 30 31 3? 33 34 35 36 3/ 38 3$ 


O 


1 















































































































































2 















































































































3 

















































































































4 



































































































































5 






































■4- 

1 













































































6 































































































































FIELD SPECIFICATION 



Line 
3 4 S 




O 

5 
z 


| ~ C/Z/D/P/B/F | 


Field Location 


Forced 


NOT USED 

20 21 72 23 24 25 26 7* 28 ?<* 10 31 32 1! 34 3S 36 3' 38 39 


Comments 


rr 

17 


s 

E 
IB 


19 


From 

9 10 11 1? 


To 

13 14 IS 16 


Field Name 


46 47 48 49 50 SI S3 S3 54 SS 56 57 58 59 60 61 6? 63 64 65 66 67 68 69 70 71 7? 73 74 
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Figure 3-2 SORT Specification Form 
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NOTE 

Whole lines of comments may also be 
included in the file; these are denoted 
by an asterisk (*) in column 7. The 
comment lines may appear anywhere in the 
specification file and serve to document 
the file in its printed listings. They 
do not affect SORT operations. 



In the following material, unless otherwise stated, the following 
criteria apply: 

• Numeric data is decimal, not octal. 

• Either leading zeroes or leading blanks are acceptable in 
right-justified entries. 

• All field position definition records begin at column 1. 



3.2.1 Header Specification 

See Section 3.2.1.1 for notes and comments: 

Columns Explanation and Legal Entries 

1-5 Page and line numbers: described in 

Section 3.2 

6 Header record identification 

Legal value: H 
7-12 Type of SORT (must be left- justified) 

Legal values: 

SORTR or blanks - Record SORT 
SORTT - Tag SORT 

13-17 Total of all key field sizes 

Legal values: 1 - 16383 

N.B.: must be equal to the total size in 
bytes of the largest record key on the file 
and right- justified 

18 Normal sort order sequence 

Legal values: 

A or blank - ascending 
D - descending 

19 - 25 (not used) 
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26 Alternate collating sequence 

Legal values: 

blank - standard ASCII sequence 

E - EBCDIC sequence 

X - user-modified ASCII sequence 

27 (not used) 

28 Output option 

Legal values: 



X - key fields created by SORT will 

be stripped from the output record 
blank - no action 

29-32 Output record length 

Legal values: 

decimal number equal to the 
number of bytes in the largest 
output record 

33-39 (not used by SORT - may be used for 

comments) 



3.2.1.1 Notes and Comments on Header Specification Entries 

Column of Notes and Comments 

Entry Affected 

18 This field may be qualified by N or 

entered in column 7 of the field 
specification (q.v.) 

26 This field identifies the sort order for 

fields identified as alphanumeric (C 
in column 8 of the field 
specification) . If X is entered 
here, the header must immediately be 
followed by ALTSEQ cards. See 
Section 3.2.1.2 for ALTSEQ card 
format. Standard ASCII is assumed 
for forced key field specifications 
and this field cannot be used to 
amend that assumption. SORT does 
not perform file transliteration. 
Files that are not already in 
standard ASCII characters must be 
transliterated before the sort. 

The EBCDIC option specifies ASCII 
characters sorted into EBCDIC 
sequence . 
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28 



29 - 32 



If a blank appears here, the key fields 
may be treated as data fields and 
moved to the output record as any 
other data field would be, whether 
relocated within the output record 
with respect to the input record or 
not . 

To determine this number, add the sizes 
of all the data fields in the field 
specifications (plus the sizes of 
the key fields if column 28 is 
blank) for the largest record in the 
file. If neither SORTT nor SORTR is 
to be run at this time, then an 
entry in this field is not needed. 



3.2.1.2 ALTSEQ Format and Notes 

Column 



Notes 



1-6 ALTSEQ - mandatory entry 

7-8 (not used) 

9-80 Replacement character groups (12) , of 6 positions each; 

each group contains the octal representations of 
two ASCII characters: the character being sorted 
out of sequence, and the character that 
corresponds to its new position in the sorting 
sequence. For example, the correct entry to 
replace an ASCII space with an ASCII zero (0) 
would be 040060; 040 for the space and 060 for 

result of this would be to sort 
same relative position in the 
Notice that preexisting 0s are 
this entry, but they may be 
affected by another entry on the same or another 
ALTSEQ card under the same header. 



the zero. The 
spaces into the 
sequence as 0s, 
not affected by 



3.2.2 Record Type Specification 

See Section 3.2.2.1 for notes and comments. 



Columns 
1-5 



Explanation and Legal Entries 

Page and line numbers. See Section 3.2 
for description 

Inclusion or Omission character 

Legal values: 

I - Include the records described 
in this line in the sort 



- omit the records described 

in this line from the sort 
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Continuation character (allows for cases 
in which several conditions define a 
single record type) 

Legal values: 

A - logical AND 

- logical INCLUSIVE OR 

Field mode (defines the processing to be 
applied to the data field defined) 

Legal values: 

B - binary 

C - alphanumeric 

D - numeric 

F - binary floating point in 
2 to 4 words 

1 - numeric with leading and 

separate sign 
J - numeric with trailing and 

separate sign 
K - numeric with sign leading 

and overpunched in first byte 
P - packed decimal 

Z - zone, see Table B-2, Appendix B 

Factor 1 (position of the base comparison 
factor is in the first byte; the first 
byte in the record is byte 1) 

Legal values: 

a decimal number - location of the 
first byte 

blanks - specifies a single byte 
field 

Factor 1 endpoint 

Legal values: 

a decimal number - location of 
last or only byte in the 
field 

Relationship of Factor 1 to Factor 2 

Legal values: 

EQ - equal 

NE - not equal 

LT - less than (i.e. Fl LT F2) 

GT - greater than 

LE - less than or equal to 

GE - greater than or equal to 
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19 Comparison factor format (indicates whether 

Factor 2 is a field or a constant) 

Legal values: 

F - identifies a field 
C - identifies a constant 

20 - 39 Factor 2 (This takes two different formats 

depending on whether Factor 2 is a field 
or a constant.) 

If Factor 2 is a field: 

20 - 23 location of first byte - a 

decimal number or blanks 
as for Factor 1. 

24 - 27 location of the last or only- 

byte - a decimal number as 
for Factor 1. 

28 - 39 (not used) 

If Factor 2 is a constant: 

20 - 39 the value of the constant 

40 - 80 (not used - available for comments) 



3.2.2.1 Notes and Comments on Record Type Specifications 

Columns Explanation 

(general) If all the records in the input file are to be 

included in the sorted output file and they all 
have the same format or you are using the entire 
record as the key, then no record type 
specification is necessary. If all the records 
have the same format and some are to be omitted, 
then only one record type specification is needed. 
If several different formats of records are to be 
sorted, then there must be a record type 
specification for each. Each record type 
specification used should be followed by its 
appropriate field specifications. 

6 If this column contains an I and there are no 

further entries in this line, all records not 
previously described are to be included in the 
sort input. Records that are not described in 
Include lines will be ignored. Because SORT 
processes Include and Omit lines sequentially, you 
should be very careful to get your lines in the 
right order, particularly if any records are 
described on more than one line. The last Record 
Specification line before a Field Specification 
must be an Include line. If you describe the 
records to be processed by omitting the unwanted 
records from the file, then you can use a line 
with an I in column 6 and no further entries in 
the line as the final record specification. 
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Multiple AND and OR lines are permissible, but the 
series will be processed strictly in sequence, 
each line ANDed or ORed to the accumulated Boolean 
expression in turn: 

If A is False and B and C are True, 
the expression A OR (B AND C) is 
True logically, but in order to 
get the correct results from 
SORT, arrange it this way: 

B AND C OR A 

SORT will react: 

(B AND C) OR A, 

which gives the required True 
value . 

On the other hand, 

A OR B AND C 

gives a True value in both the 
SORT and non-computerized logic 
as it stands. 

C - alphanumeric information limited to 256 bytes 

D - numeric value, maximum size 8 bytes after 
conversion to binary. If the number is 
presented in standard ASCII numeric format, 
as for a decimal number with or without 
decimal point, floating point exponent, or 
sign at the beginning, the SORT will convert 
the number to binary. But the maximum size 
is still 8 bytes. 

F - maximum size 8 bytes - two or four word 
floating binary representation before 
conversion 

Z - ASCII zone, maximum size 1 byte - see Table 
B-2 in Appendix B 

Factor 1 - Sort identifies records by comparing 
the value of one or more fields in a record 
with constants or other fields in the 
record. These other fields or constants are 
referred to as Factor 2. 

defines the Factor 1 - Factor 2 relationship 

Factor 2 - See notes under Factor 1 above. If 
Factor 2 is a field, it must be the same 
length as Factor 1. If a constant, after 
conversion to the corresponding internal 
format, be the same length as Factor 1 and 
be in the same mode (see Field Mode, 
position 8) . 



SORT EXECUTION OPTIONS 



3.2.3 Field Specifications 

There are normally a set of field specifications following each record 
type specification in the specification file set. (For one exception, 
see paragraph 3.2.2.1, general notes.) If there are no record type 
specifications, any appropriate field specifications follow the 
header. Field specifications have two main jobs: 

• to describe the output file format 

• to determine, for each record type, the keys on which the 
sort is to be based. 

List the key field specifications first, in order of decreasing 
significance. Then add data field specifications to put out any 
portions of the original input record. 

List the Key and Data field specification lines in the specification 
file in the same order as the required output record format. SORT 
creates the output record according to the order, size, and contents 
of the key and data specification lines. Place an X in column 28 of 
the Header to strip unwanted key fields from the output record. If 
the key field is specified twice, as a key field and as a data field, 
the key field can remain in the output record where the data field 
specification puts it, even if the key fields are stripped. See 
Section 3.2.3.1 for further commentary. 



Columns Explanations and Legal Entries 

1-5 Page and line numbers - see Section 3.2 

6 F - specifies a field specification 

7 Field type - specifies keys and their sort 



sequences and data fields 

Legal values: 

N - key field, normal sort 

sequence (see position 18 of 
Header) 

- key field opposite sequence 

F - key field, special treatment 

required (see positions 17 - 19) 

D - data field (if used, then 
column 8 should be C) 

8 Field type - should be C if column 7 is 

D - these options are the same as those 
for column 8 of the record type specifi- 
cations 

9-12 Field location - location of first byte of 

multi-byte field 

Legal values: 

a decimal number - location of first 
byte of field 

blanks - specifies one-byte field 
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13 - 16 Field location - last or only byte 

Legal values: 

a decimal number - location of last 
or only byte in the field 

17 - 19 Forced key fields 

17 Trigger character - identifies the 
character needed to trigger the 
force : 

Legal values: 

blank - the force always occurs 
any other character - the force 

occurs only if this character is 

found 

18 Replacement character 
Legal values: 

any legal character 

19 Continuation character 
Legal values: 

blank - this is a new forced 
key 

any other character - this 
key is continued from 
the previous line 

20 - 80 (not used - available for comments) 



3.2.3.1 Notes and Comments on Field Specification Entries 
Columns Explanation 

7 Enter key fields first in order of 

decreasing significance. 

17 - 19 Use this field to change the content of 

a 1-character key field, thereby 
changing the sorting sequence. The 
original data will still appear on the 
output record, since only the key will 
be changed. To specify a forced key, 
put F in column 7 of the field 
specification and the nature of the 
force in columns 17 - 19. Since the 
force is based on characters, there must 
be a C in column 8. A force does not 
apply to any other keys or fields than 
the one stated. 
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To help you understand how these forced key fields affect the SORT, 
here is a description of how the SORT handles these fields: 

When column 7 contains an F, SORT sets up a one-byte field in its key 
area and sets its value to either 377 (octal) for ascending or for 
descending sequence. Note that the alternative collating sequence 
does not apply to forced key characters. 

If column 17 is not blank, SORT compares its contents to the content 
of the field defined in columns 13 - 16. If an equal condition 
occurs, SORT moves the character to the reserved key byte previously 
described. 

By using more than one Field Specification, you can force more than 
one character out of normal sequence, such as sorting the entire 
alphabet out ahead of numerics. But beware: 

1. Unless the displaced character is itself displaced to another 
position in the sorting sequence, it will appear with the 
character displacing it in the order in which the two 
characters were found in the input file. Thus, if A 
displaces ! and a series appears in the input file as (A, B, 
!, A, ! , ! , A, C, D) , the sorted output will be (A, ! , A, i, 
! , A, B, C, D) , so. . . 

2. When in doubt, force the displaced character elsewhere, 
particularly when it is known to appear in the input file and 
is not omitted elsewhere in the SORT specification file. 

If, on the other hand, column 17 contains a blank, no comparison is 
performed and the value of column 18 always replaces the initial value 
in the reserved key byte. This has the following results: 

1. When associated with conditional keys in preceding lines, 
records not satisfying the prescribed conditions can be 
grouped into any position in the output file, not necessarily 
the end of the file. 

2. When this specification stands alone, it becomes an 
unconditional force of all records in the group. This form 
can be useful when the group is already identified by a 
record type specification. It has no effect on the entire 
file if applied to the entire file. 

If column 19 of the field specification is blank or the preceding line 
does not specify a force key, SORT only reserves a new key byte. The 
same byte is modified in all other cases. This makes it possible to 
combine several conditions within the same key, such as arranging an 
output file in the order 4, 2, 3, 1, rather than 1, 2, 3, 4 or 4, 3, 
2, 1. However, SORT still expects the field location to be defined in 
columns 13 - 16, even if each continuation line covers the same field. 



3.2.4 Using a Specification File 

The sample input file contains records in the format shown in Figure 
1-1. The file may contain null records such that there may be a 
record identifier and no other data in the record. 

SORTR is entered in columns 7 through 11 of the Header. The header 
specification also indicates that the key is to be sorted in ascending 
sequence and that an alternate collating sequence is to be used. The 
ALTSEQ line following the header tells SORT to interpret all nulls as 
spaces. 
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The null records are omitted from the sorting process with an Omit 
line in the record type specification. The Include lines direct SORT 
to process only the RESTOCK records where the present amount of stock 
is less than the stock quantity allowed. ORDER Records, SALES 
Records, and RESTOCK records where the present amount of stock is 
greater than the stock quantity allowed are ignored. 



The field specification 
on the reorder number 
Unit Code, and Cost per 
to the output record 
number in positions 1-6 
per Unit in position 
fields and the output r 
calculated from the fie 



shows that the selected records will be sorted 
Since this is a SORTR, the Item Number Code, 

Unit data fields, in positions 2-14, transfer 
s. The output records will have the reorder 
, and the Item Number Code, Unit Code, and Cost 
s 7-19. Note that the total length of the key 
ecord length in the header specification are 
Id sizes indicated in the field specification. 



EQUIPMENT 
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SORT SPECIFICATIONS 

HEADER SPECIFICATION 
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Figure 3-3 Header Specification Entries 
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3.3 SORT SPECIFICATIONS SUMMARY 



Table 3-2 
Header Specifications 



Column 


Entry 


Explanation 


6 


H 


Header Specification 


7-12 


SORTR 
SORTT 


Record Sort 
Tag Sort 


13-17 


1 - 16383 


Decimal number specifies total 
length of all key fields 
listed in Field Specifications 
(must be the maximum for 
SORTR) 


18 


A or Blank 
D 


Processing sequence: Ascending 
or Descending 


26 


Blank 

E 

X 


ASCII collating sequence 
EBCDIC collating sequence 
ASCII with modification listed 
in following lines 


28 


Blank 


The key fields will reside at 
the beginning of each output 
record 




X 


The key fields will be 
stripped from the beginning of 
the output records 


29-32 


Decimal Number 


This entry specifies the 
number of bytes of all key and 
data fields listed in the 
Field Specifications (must be 
maximum for SORTR) 
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Table 3-3 
Record Type Specifications 



Column 


Entry 


Explanation 


6 


I 


The records described in this record 
specification will be included in the 
sorting process. If there are no 
entries in the following columns, all 
records not yet described will be 
included 







The records described in this record 
specification will be omitted from 
the sorting process 


7 




inc k>uuui. Liuu lueiiLiiieu uy uiixo 

record specification is a logical AND 
with the condition from the previous 
line 







The condition identified by this 
record specification is a logical OR 
with the condition from the previous 
line 


8 


B 


Binary - the field contains 2's 
complement binary data 




C 


Character - the field in columns 9-16 
(Factor 1) is alphameric 




D 


Digit - use the digit value or 
convert the number to binary 




F 


Floating - treat the field as a 2- or 
4-word floating binary representation 




I 


Same as D but with sign leading and 
separate, i.e., the first byte of the 
field is a + or a - 




J 


Same as D but with sign trailing and 
separate, i.e., the last byte of the 
field is + or - 




IS. 


Same as D but with sign leading 
overpunch, i.e., sign is superimposed 
upon first byte of the field 




P 


Packed - the field contains p-acked 
decimal data 




Z 


Zone - use the zone value for the 
entry 



(continued on next page) 
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Table 3-3 (Cont.) 
Record Type Specifications 



Column 



Entry 



Explanation 



9-12 



13-16 
17-18 



19 



20-23 



24-27 



20-39 



Decimal Number 



Blanks 



Decimal Number 



EQ 
NE 
LT 
GT 

LE 

GE 



Decimal Number 



Blanks 



Decimal Number 



Character String 



Location of the first 
field (Factor 1) 

Single byte field 



byte of the 



Location of last byte of field 
location of single byte field 



or 



1 must equal Factor 2 

1 must not equal Factor 2 

1 must be less than Factor 2 

1 must be greater than Factor 

1 must be less than or equal 



greater than or 



Factor 
Factor 
Factor 
Factor 
2 

Factor 
to Factor 2 
Factor 1 must be 
equal to Factor 2 



The following entry describes a field 
to be compared with the field 
specified in columns 9 through 16 

The following entry describes a 
constant to be compared with the 
field specified in columns 9 through 
16 



Location of the first byte of the 
field (Factor 2) compared with Factor 
1 

Factor 2 is a single byte field 



Position of last byte of Factor 2 
field or location of single-byte 
field 



The constant compared with Factor 1 
entry must agree with mode and length 
of Factor 1 
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Table 3-4 
Field Specifications 



Column 


Entry 


Explanation 


6 


F 


Field Specification 


7 


N 


Normal - key field sequenced as indicated 
in column 18 of header 







Opposite - key field sequenced opposite 
to column 18 of header 




F 


Forced - single byte key field with 
special sequence 




D 


Data field 


8 


B 


Binary - the key field is in 2's 
complement binary notation 




C 


Character - alphanumeric key or data 
field 




D 


Digit - use digit value or convert to 
binary for FORTRAN IV numbers 




F 


Floating - the key field is in 2- or 
4-word floating binary representation 




I 


Same as D but with sign leading and 
separate, i.e., the first byte of the 
field is a + or a - 




J 


Same as D but with sign trailing and 
separate , i.e., the last byte of the 
field is + or a - 




K 


Same as D but. with sign leading over- 
punch, i.e., sign is superimposed upon 
first byte of the field 




P 


Packed - the key field is in packed 
decimal 




Z 


Zone - zone value 


9-12 


Decimal 
Number 


Location of first byte of field 


18 


Replacement 
Character 


The character which will be substituted 
when the force condition (if any) is met 


19 


Continuation 
Character (any 
character other 
than blank) 


This specification line covers the same 
forced key field as the preceding line(s) 




Blank 


This line designates a new forced key 



3-21 



CHAPTER 4 



ERROR CONDITIONS 



4.1 ERRORS IN SORT: GENERAL COMMENTS 

When SORT exits, it always prints the status of the sort operation. 
The status message is either SUCCESS or an error message for one of 
the following errors: 

• Command decoder errors 

• Specification file errors 

• I/O errors 

SORT errors are reported at the terminal only and are not recoverable. 
The format of a SORT error is as follows: 

SRT — control-phase : ?message [-RMS-status-code] 

where: 

control-phase is the SORT phase in control at the time the 

error occurred. Legal values are: 

C - command decoder 
M - merge 
P - presort 

message is a one-line brief explanation of what 

happened . 

RMS-status-code is a decimal status code returned by RMS for 

additional information on file errors only. 
If RMS is not impacted by the SORT error, 
this status code does not appear. Status 
codes likely to be seen are listed with their 
meanings in Section 4.7. 



4.2 COMMAND DECODER ERRORS 

If your error message has a control-phase of C, you have made a 
command decoder error. The command decoder error messages and their 
probable causes are listed below: 

1. SORT COMMAND ERROR 

a. Too many input files (more than two, including 
specification file) or output files (more than one) 
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b. General syntax error 

c. Too many switches 

d. Erroneous switches on the specification file 

e. An undefined switch 

IMPROPER SWITCH: /FI 

a. Less than three or greater than eight scratch files. 

b. Invalid terminator 

NOTE 

Valid terminators are period, comma, slash, equal 
sign and <RET>. " INVALID TERMINATOR" means that 
some other character was used as a terminator or 
that SORT expected to find a terminator where 
none existed. 

IMPROPER SWITCH: /KE 

a. Invalid letter or value 

b. Start location or size is 

c. No period (.) between start location and size 

d. Illegal size for data mode 

e. Invalid terminator (See NOTE above) 

TOO MANY KEYS 

Buffer space overflowed 

NOTE 

SORT reserves a buffer area for storage of a table 
based on the input specifications in order to control 
the processing of each record. This space should be 
ample for all situations to make this error unlikely. 

NO KEYS SPECIFIED 

There are no key switches in the command string and no 
specification file has been declared. 

KEY AFTER LAST BYTE OF RECORD 

The end of an input record key field goes past the stated 
record size (switch or specification) . 
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7. NO /FO SWITCH 

You omitted the /FORMAT switch on the input file. 



8. IMPROPER SWITCH: /FO 

You have not specified a valid format type. 



9. IMPROPER SWITCH: /PR 

You specified an invalid sort process. 



4.3 SPECIFICATION FILE ERRORS 

In general, the detection of an error in the Specification File 
results in an appropriate message followed by: 

• a printout of the entire record, or 

• a printout of the record up to the point where the error was 
detected . 

1. INVALID CHARACTER 

a. Column 6 is not H,I,0,F and record is not ALTSEQ. 

b. Process is not SORTR , SORTT, or blank. 

c. Collating sequence is not blank, E, or X. 

d. Data type is not B, C, D, F, I, J, K, P, Z. 

e. Key type is not D, F, N, 0. 

f. Logical entry is not A, 0, blank, or *. 

2. ILLEGAL FIELD 

a. A numeric field in specification contains other than 
decimal digits or blanks. 

b. No key size is given in Header specification. 

c. No output size is given in Header Specification. 

d. ALTSEQ is misspelled. 

e. ALTSEQ entries do not represent 7-bit octal values. 

f. Last location is less than first location in record field 
identification. 

g. Size is invalid for data mode. 

h. Sizes of Factors 1 and 2 in Record Specification do not 
match. 
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i. Compare relation is undefined. 

j . Forced field is other than type C or more than one 
position . 



ILLEGAL CONSTANT 

a. Constant given in Factor 2 is greater than 20 characters. 

b. Mode of constant does not agree with mode of Factor. 

c. Invalid characters appear in constant (e.g., non-digits 
if the constant is numeric) . 

d. Sign is omitted from binary or packed constant. 



NO HEADER 

a. First record of specification file is not an 
specification. 



INCORRECT SEQUENCE 

a. Numeric record sequence is lower than sequence previously 
encountered . 

b. No valid data specification appears when keys are to be 
stripped from output. 

c. Record specification after "include-all" ("include-all" 
should be last) . 

d. Key specifications appear after data specifications. 



NO ALTSEQ 

a. Specification for alternate collation entered in Header 
column 26 but no ALTSEQ Specifications follow. 



TOO MANY SPECIFICATIONS 

a. Number of specifications for a particular type of record 
have overflowed the buffer space. 



NOTE 



SORT reserves a buffer space for storage 
of a table based on the input 
specifications and used to control the 
processing of each record type. This 
space should be ample for all situations 
to make the error unlikely other than in 
very exceptional circumstances. 
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8. LAST RECORD SPEC NOT "I" 

a. Last record specification in file was OMIT. 

9. ILLEGAL KEY 

a. A forced field specification was included in an Index 
SORT (SORTI). 

10. NO KEYS SPECIFIED 

a. No key specification appeared before data specifications 
in a specification file set. 

4.4 I/O ERRORS 

Once the sort is under way the only normal errors that can occur are 
due to I/O failure, as indicated below: 

1. OPEN (IN/OUT) FAILURE ON filename. ext xxxx 

The file could not be opened by RMS. The parameter xxxx is 
the appropriate RMS error code. 

2. INPUT/OUTPUT ERROR ON filename. ext xxxx 

RMS generated an error while reading or writing this file. 
The parameter xxxx is the appropriate RMS error code. 

3. BAD RECORD SIZE ON filename. ext 

RMS tried to read a record on this file that is larger than 
the size specified in the /FO switch. 

4. NO ROOM IN filename. ext 

a. The storage capacity of the device has been exhausted 
while writing the output file. 

5. INAPPROPRIATE FILE ORGANIZATION 
a. /IN switch was not specified. 

6. TEMP FILE ERROR xxxx 

a. An I/O error occurred on a scratch file. xxxx is the RMS 
error code. 
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4.5 CONTROL PROGRAM ERRORS 

4.5.1 Pre-Sort Errors 

1. NO DATA IN INPUT FILE filename. ext 

a. There are no records in the input file. 

b. The file is not an RMS file. 

2. INVALID KEY FIELD DATA filename . ext 

a. An inappropriate byte has been found in a field described 
as D, I, J , K or Z mode. 

4.5.2 Merge Errors 

1. # OF OUTPUT RECORDS DOES NOT MATCH # INPUT 

a. The number of records released to the sort does not equal 
the number returned. 

NOTE 

This is a warning message only. The 
output file contains as many records as 
specified in the end-of-sort message. 

4.6 OTHER ERRORS 

Occasionally, errors may occur due to the rejection of data passed to 
the SORTS subroutine package. They are reported as: 

SORT ERROR — CODE nn 

where nn is the code number returned by a SORTS subroutine (described 
in paragraph 4.8). 

4.7 RMS ERROR CODES 

A complete listing of RMS status codes can be found in Appendix D. 
The status codes that appear in this section represent errors that you 
will be most likely to encounter. 

The status codes in Table 4-1 are due to file primitive failure. 
Check to see if your file is readable and in the correct format. If 
these status codes recur, please send an SPR to DIGITAL. 
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Table 4-1 
RMS Status Codes for TRAX 



Code 


Brief Explanation 


-160 


Read error on file header attributes 


-176 


Write error on file header attributes 


-400 


Deaccess error during $CLOSE 


-520 


Device positioning error 


-560 


Enter function failure 


-624 


File extension failure 


-1088 


File could not be marked for deletion 


-1456 


Remove function failure 


-1520 


Error while reading prologue 


-1776 


File write error 


-1792 


Error while writing prologue 



The status codes listed in Table 4-2 appear because the file 
attributes you gave did not match those of the existing file. 

Table 4-2 

RMS File Attribute Mismatch Status Codes 



Code 


Brief 


Explanation 


-192 


Bucketsize exceeds maximum 




-480 


Dynamic memory exhausted 




-976 


Key size equals zero or is 
not 4 (relative file) 


too large (indexed file) or is 


-1168 


Not enough room to open an 


indexed file 



Table 4-3 gives commonly occurring status codes other than RMS. 
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Table 4-3 
Common Non-RMS Status Codes 



Code 


Brief Explanation 


-112 


Variable length records on ANSI-labelled magtape 
ANSI D format 


are 


not 


-432 


RMS tried to access a deleted record 






-448 


Syntax error, no such device, or device inappropriate 
operation 


for 


-464 


Svntax error in directorv name 






-496 


Di rprtorv not" found 






-512 


Device not ready 






-672 


RMS a t" t" pninhp^ i"0 p r fss 1" ^ an al rpadu pyi cit-inn file 






-704 


i. vV^ rvCU k-/ ultv UIlvL U OC1 U^^COu 14 1 4 X w U 






-736 


Pi 1 p nnt" f"Oiinrf 

X. IXC liVy v XV^UllU 






-752 


Rvn l"35f prrftr in f" 1 1 p n amp 

uyliUaA ^ X. X. vf X Xll XXXC 1 1 Clill \~ 






-768 


Tnual i H 'FiIp ont" i on<5 f al en nprnrs if* unn t* r v tr> 

XUVuX XU X. X X C W J"-* L XU 11a ^CIX mv Uv^l^L O XX. _y \J Li L X y L- V_/ 

contiguous file) 




a 


-784 


Device full: cannot create or extend file 






-880 


Illegal operation - see Appendix D for examples 






-896 


Illegal record in sequential file or invalid count 


field 




-1008 


Magtape is not ANSI-labelled 






-1024 


Logical channel busy 






-1040 


Invalid logical channel number 






-1120 


Maximum record size equals zero during $CREATE 






-1152 


Not at end of file 






-1408 


Invalid record address 






-1424 


Invalid or illegal record format 






-1440 


Target bucket locked by another task or stream 






-1536 


Invalid record in indexed file - file may be damaged 




-1568 


Record size error during $PUT or $UPDATE 






-1744 


Syntax error in file version number 






-1784 


Device wr ite-*locked 







See Appendix D for a more complete explanation of each status code. 
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4.8 SORTS ERRORS 

Whenever SORTS detects an error, it returns an octal non-zero code in 
the location specified by <Location of Error Code> in the most recent 
call. In addition, for I/O errors, Rl contains the address of file 
control block for the file in error. The status supplied by RMS is 
set into the error status word of that file control block. (See 
Appendix D for error code values.) 

The error codes (octal) and their meanings are listed below: 



Error Code Meaning 

00 No errors. 

01 Device input error. 

02 Device output error. 

03 OPEN (IN) failure. 

04 OPEN (OUT) failure. 

05 Size of current record is greater than maximum size. 

06 Not enough work area. 

07 RETRN was called after it had exited with a negative 
error code (end of sort) . 

10 SORT routine called out of order (The order of the 
calls should be RSORT, RELES, MERGE, RETRN, ENDS). 

11 Sort already in progress (To do a second sort, ENDS 
must be called to clean up the first sort) . 

12 Key size is not positive, SORTS detected a zero or 
negative key size in its calling parameter. 

13 Record size not positive. 

14 Key address is not even (the keys must start at an 
even address because SORT uses word moves) . 

15 Record address is not even. 

16 Scratch records will be too large (the size of the 
keys plus the size of the largest record must be 
less than 37776 octal) . 

17 Too few scratch files are given (a minimum of 3 
scratch files must be specified) . 

20 Too many scratch files are given (a maximum of 10 
scratch files may be specified) . 

21 End-of-str ing record was detected where none was 
expected . 

22 Unexpected end-of-file. 

23 SORT found a record larger than expected. 

24 Record length is not standard for SORTT. 
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FILES 



5.1 FILE NAME CONVENTIONS 

Input, output, and specification files may have any name acceptable to 
TRAX. 

SORT generates its scratch files by using the temporary file creation 
mechanisms of TRAX. Scratch files are automatically deleted from your 
file directory by the operating system when SORT is no longer running. 



5.2 FILE MAINTENANCE 

At the end of a successful run, SORT stores the new output file on the 
device you specified. The new output file may then be used as 
immediate input to some other program. The input and specification 
files are unchanged. 



5.3 FILE ALLOCATION 

To optimize your sort for speed, SORT tries to allocate in advance the 
output file and each scratch file at maximum size. SORT does this by 
making an educated guess about the space needed. Under the tag and 
record sorting processes, SORT allocates as much space to the output 
file as to the input file. Each scratch file is arbitrarily given 50 
percent more space than the input file, no matter what process is 
used . 

Usually, this pre-allocation process causes no problems. But you 
should be aware of the instances in which problems due to 
over-allocation do arise and what you can do about them. 

Your pre-allocation size may be too large if one or more of the 
following conditions are true: 

1. You are sorting from an indexed file. 

2. You are using OMIT lines in the specification file. 

3. You are using the reformatting option in the specification 
file. 

4. You are using a smaller record size in the output file than 
in the input file. 

Some wasting of space in the output file can usually be tolerated, but 
on a crowded disk you may be notified of insufficient space when there 
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really was enough to hold your file. Try cutting down on the amount 
of space by making a conservative estimate of what you need and 
including that estimate in the /AL switch on the output file side of 
the command string. 

You may perhaps be more concerned about the situation in which you get 
the following error message when you try to sort a large file: 

P:?TEMP FILE ERROR -784 

This means that there is no more room for the allocation of scratch 
files. Here, too, there may be space wasted due to over-allocation. 
Try cutting down the size of the scratch file to one third that of the 
input file. If the error persists, trim the size again. If this does 
not work, then the disk may be too full to handle the sort. 



5.4 SCRATCH FILES 



5.4.1 Scratch File Structure 



The scratch files consist of one or more sequenced strings of records, 
followed by an end-of-file flag word. Each string consists of zero or 
more records, in order by key, followed by an end-of-str ing flag word. 
The number of strings on each file varies from time to time as the 
sort progresses, until, at the end of the merge phase, there is one 
string on each file. If there is not enough data in the input file to 
produce at least one string on each scratch file, the unused files 
will contain only an end-of-file flag word. 

The format of the records stored in these files is as follows: 



Word 1 Size of the data portion in bytes. The 

maximum acceptable to SORT is 16K (up to 
37777 octal) . 

Words 2 through n After possible conversion to a form more 

suitable for logical comparison, the key 
fields are stored in reverse. 



Words n+1* through m The data portion for 

is the record as 
file; for SORTT , it 
record pointer. 



record sort (SORTR) 
read from the input 
is a 2-word relative 



Two unique records also appear in the scratch files as markers. Each 
is one word only containing all bits except as below: 



• Bit 15 = 1 indicates end-of-str ing flag 

• Bit 14 = 1 indicates end-of-file flag 



* When controlled by specification file, word n+1 is used to hold an 
internal control pointer, and the data starts at n+2. 
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5.4.2 Using Scratch Files 

The scratch files switch, FILES (see Section 3.1.6), is only effective 
when operating under special conditions. For each scratch file 
potentially to be used, a certain amount of core is required to 
establish internal control blocks. This necessarily makes the sort 
take longer by: 

1. Restricting the space available for record storage during the 
sort, and 

2. Forcing the usage of scratch files even for small input files 

By specifying a smaller number of scratch files than the default, you 
may be able to release sufficient space to do the whole sort in core 
and thereby speed up the sort of a small file. 
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APPENDIX A 
CHARACTER SETS USED BY SORT 

Table A-l: The ASCII Character Set with Corresponding EBCDIC 
Codes 



Table A-2: The Subset of the EBCDIC Character Set Used by 
SORT When EBCDIC Sorting is Requested 
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CHARACTER SETS USED BY SORT 



Table A-l 

The ASCII Character Set with Corresponding EBCDIC Codes 





ASCXX 






ASCII 




Character 


Code 


Code 


Ciiar act 6 it 


Code 


Code 


NUL 


000 






1 Art 
X U U 


1 1A 
X / 


SOH 


UUl 


UUJ. 




i n i 

X U X 


301 


STX 




002 


B 


102 


302 


ETX 


UUJ 


003 


C 


103 


303 


EOT 


004 


067 


D 


104 


304 


ENQ 


005 


055 


E 


105 


305 


ACK 


n rv £ 


U JO 




106 


306 


BEL 


007 


057 


Q 


107 


307 


DO 


010 


026 


fj 


110 


310 


urn 

n x 


011 


005 


J 


111 


311 


T P 


012 


04 5 


J 


112 


321 


V 1 


013 


013 


K 


113 


322 


FF 


014 


014 


L 


114 


323 


CR 


015 


015 


M 


115 


324 




016 


16 


N 


116 


325 


sx 


017 


017 


o 


117 


326 




020 


020 


p 


120 


327 


DCl 


021 


021 


y 


121 


330 


DC 2 


022 


02 2 




122 


331 


DC 3 


023 


023 


s 


123 


342 


DC 4 


024 


074 


T 


124 


343 


NAK 


025 


075 


U 


125 


344 


CVW 
□ Xu 


026 


062 




126 


345 


ETB 


n 97 


046 


w 


127 


346 


CAN 


m r\ 

UJU 


030 




130 


347 


EM 




mi 


y 


131 


350 


SUB 


m 9 


077 




132 


351 


ESC 


n n 

Ujj 


047 


r 


133 


112 


FS 


034 


034 


\ 


134 


340 


GS 


035 


035 




135 


132 


RS 


036 


036 




136 


137 


US 


037 


037 




137 


155 


SPC 


04 


100 




140 


171 


* 


fi A 1 


XX/ 




141 


201 




04 2 


177 




142 


202 


f 


043 


173 




143 


203 


$ 


044 


133 


d 


144 


204 


% 


045 


154 


e 


145 


205 


& 


U *i D 


i 9n 
x ^ u 




146 


206 




047 


175 




147 


207 


I 


050 


115 


h 


150 


210 


J 


051 


135 




151 


211 




052 


134 


3 


152 


221 




Ujj 


116 




153 


222 




054 


153 


1 


154 


223 


- 


055 


140 


m 


155 


224 




U JU 


113 


" 


156 


2 25 


/ 


Uj / 


141 
X ** X 




157 


226 





060 


i £ r\ 

J D U 


P 


160 


227 


1 


Uox 


1 C 1 
Jul 


<3 


161 


230 


2 


062 


"5 £ 9 


r 


162 


231 


3 


063 


jDj 


s 


163 


242 


4 


064 


364 


t 


164 


243 


5 


065 


365 


u 


165 


244 


6 


066 


366 


V 


166 


245 


7 


067 


367 


w 


167 


246 


8 


070 


370 


X 


170 


247 


9 


071 


371 


y 


171 


250 




072 


172 


z 


172 


251 




073 


136 




173 


300 


< 


074 


114 




174 


152 




075 


176 




175 


320 


> 


076 


156 




176 


241 




077 


157 


DEL 


177 


007 



A-2 



CHARACTER SETS USED BY SORT 



Table A- 2 

The Subset of the EBCDIC Character Set Used by SORT 
when EBCDIC Sorting is Requested 1 





EBCDIC 


ASCII 




EBCDIC 


ASCII 




Code 


Code 


Cnaracter 


Code 


Cods 


NUL 


000 


000 




203 


143 


eriu 
OUll 


UU1 


a a i 

UUl 




OA A 


1 A A 


STX 


002 


002 


e 


205 


145 


ETX 


003 


003 


f 


206 


146 


HT 


005 


m l 

U XX 


9 


on7 


1 A 7 
Xl / 


DEL 


007 


1 77 

X / / 


XI 


z XU 


IjU 


VT 




U ± o 


i 


Oil 
ZXX 


151 


FF 




r\ l a 

U X*i 


j 


1 
Z Z X 


ICO 

loz 






rtIC 

U1j 




7 

z z z 


1 CO 

ID j 


so 


a i c 


ni c 
U iD 




O OT 
Z Z j 


IRA 


SI 


017 


017 


m 


224 


155 


DLE 


020 


020 


n 


225 


156 




n oi 


ATI 

U Z X 


o 


z z o 


1j / 


DC 2 


022 


022 


P 


227 


160 


DC 3 


23 


n o 7 




230 


1 CI 

X o X 


BS 


026 


u xu 


r 


231 


162 




03 


UJU 




241 


176 


EM 


ft")! 
UJi 


U j1 


s 


*5 A O 


1 


FS 


034 


034 


t 


243 


164 


GS 


035 


035 


u 


244 


165 


TJC 

K.O 


036 


UjD 


v 


24 5 


166 


US 


037 


037 


w 


246 


167 


LF 


045 


m o 


x 


247 


17 


ETB 


046 


027 


y 


250 


171 


ESC 


047 


U J J 


z 


251 


17 2 


ENQ 


ncc 
UjD 


uu j 




A A 

J u u 


173 


ACK 


056 


006 


A 


301 


101 


BEL 


057 


007 


B 


302 


102 


S YN 


no 


U/u 




3 03 


X U J 


EOT 


uo / 




D 


304 


1 AA 
X U 1 


DC4 


074 


024 




3 05 


X U J 


NAK 


075 


025 


p 


306 


106 


SUB 


u / / 


03 2 


n 

Vj 


307 


1 AT 

x u / 


SPC 


1 

1UU 


U 4 U 


H 


310 


110 


r 
L 




1 ^ 7 
X j J 


X 


Til 


111 




113 


056 






175 


< 


114 


074 


j 


321 


112 


( 


115 


050 


K 


322 


113 


+ 


116 


053 


L 


■JOT 

j Z j 


1 1 A 


• 


1 I T 

XI / 


041 


M 


"5 OA 
J Z «i 


XXD 


& 


ion 


U4 b 


N 


•JOC 

j Z D 


1 1 c 
XX 


j 


ion 
1j Z 


1 "5 £ 





7 0S 
j Z 


117 
XX/ 


$ 


133 


044 


P 


327 


120 


* 


134 


052 


Q 


330 


121 


) 


lit: 


U J X 


R 


J J X 


TOO 
1 Z Z 






rt 7 "5 


\ 


340 


13 4 


t or* 


1^7 




o 
o 


34 2 


1 23 




14 


I) J J 


T 


7 4 7 


124 


/ 


1 A 1 


n c7 


U 


*> A A 
J 4 fl 


1 O R 
X Z D 




ICO 
X3 Z 


X 1 H. 


V 


j ft D 


1 0£ 
X ZD 


, 


153 


054 


w 


346 


127 


% 


154 


045 


X 


347 


130 


or 


155 


137 


Y 


350 


131 


> 


156 


076 


Z 


351 


132 




157 


077 





360 


060 




171 


140 


1 


361 


061 




172 


072 


2 


362 


062 


# 


173 


043 


3 


363 


063 


@ 


174 


100 


4 


364 


064 


i 


175 


047 


5 


365 


065 




176 


075 


6 


366 


066 




177 


042 


7 


367 


067 


a 


201 


141 


8 


370 


070 


b 


202 


142 


9 


371 


071 



1 This table shows only those EBCDIC characters for which there are 
ASCII equivalents. It therefore illustrates the collating sequence 
SORT applies when the Header Specification contains E in column 26. 
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APPENDIX B 
PRINTABLE CHARACTERS 



Table B-l : Printable Characters Grouped by Equal Digits 
Table B-2: Printable Characters Grouped by Equal Zones 



B-l 



PRINTABLE CHARACTERS 



Table B-l 

Printable Characters Grouped by Equal Digits 



Group 


Character 


DEC 29 
Card Code 


Group 


Character 


DEC 029 
Card Code 





blank 


No punches 


5 


E 


12-5 




& 


12 




N 


11-5 




- 


11 




V 


0-5 












5 


5 


1 


A 


12-1 


6 


F 


12-6 




J 


11-1 







11-6 




/ 


0-1 




w 


0-6 




1 


1 




6 


6 


2 


B 


12-2 


7 


G 


12-7 




K 


11-2 




P 


11-7 




S 


0-2 




X 


0-7 




2 


2 




7 


7 


3 


C 


12-3 


8 


H 


12-8 




L 


11-3 




Q 


11-8 




T 


0-3 




Y 


0-8 




3 


3 




8 


8 


4 


D 


12-4 


9 


I 


12-9 




M 


11-4 




R 


11-9 




U 


0-4 




Z 


0-9 




4 


4 




9 


9 
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PRINTABLE CHARACTERS 



Table B-2 

Printable Characters Grouped by Equal Zones 







DFT 2*3 






UCi k_ U £. J 


Group 


Character 


Card Code 


Group 


Character 


Card Code 





& 


12 


2 










( 


12-5-8 




% 


0-4-8 




+ 


12-6-8 




i 


0-3-8 




• 


12-3-8 




/ 


0-1 




< 


12-4-8 




> 


0-6-8 




1 


12-7-8 




? 


0-7-8 




A 


12-1 




S 


0-2 




B 


12-2 




T 


0-3 




C 


12-3 




U 


0-4 




D 


12-4 




V 


0-5 




E 


12-5 




W 


0-6 




F 


12-6 




X 


0-7 




G 


12-7 




Y 


0-8 




H 


12-8 




Z 


0-9 




I 


12-9 








1 


- 


11 


3 


Blank 


No punches 




i 


11-2-8 




ii 


7-8 




$ 


11-3-8 




# 


3-8 




) 


11-5-8 




• 


5-8 




* 


11-4-8 




: 


2-8 




/ 


11-6-8 




= 


6-8 




J 


11-1 




§ 


4-8 




K 


11-2 




1 


1 




L 


11-3 




2 


2 




M 


11-4 




3 


3 




IN 


X -L— D 




A 
1 


A 
*± 







11-6 




5 


5 




p 


11-7 




6 


6 




Q 


11-8 




7 


7 




R 


11-9 




8 


8 










9 


9 



B-3 



APPENDIX C 
SORT PROGRAM EXAMPLES 



EXAMPLE 1: SALES LIST 



Input Record Positions 



1-5 Customer Number (CUSTNO) 

6-39 Customer Name (CUSTNM) 

52-59 Date 

60-65 Item Number (ITEMNO) 

66-70 Item Quantity (ITEMQY) 

71-77 Price 

78-80 Blanks 



This Record Sort is primarily intended to produce reformatted records. 
The structure of the input file is indicated above. 

The input file contains only one record type, therefore no Record Type 
Specifications are needed. The keys for the sort are CUSTNO , ITEMNO, 
and ITEMQY, with the last key sorted in descending sequence. The 
output file will have records ordered from lowest to highest customer 
number, with the lowest to highest item number records within each 
customer number category, and the highest to lowest item quantity in 
each item number category. 

The order of the data field specifications reformat the output record. 
Note the use of the blank in columns 78 and 79; the data will be set 
off in field columns. 
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SORT PROGRAM EXAMPLES 



EQUIPMENT 
CORPORATION 



SORT SPECI FICATIONS 

HEADER SPECIFICATION 



75 76 77 78 79 80 

[sMile[s| 1 



SORTR 
SORTT 
SORTA 
SORTI 



Key F.el 



NOT USED 



SORTR.T 



Comments 
gram Identifies 



; 59 60 61 62 63 I 



n 



h SORT ft 



life A 



FIELD SPECIFICATION 



NOT USED 



op 



PC. 

pp 

PC 



fe5 



_3«i_ 



s 



— 



75 76 77 78 79 



FIELD SPECIFICATION 



S3 54 55 56 57 58 59 60 61 6? 63 64 65 66 6? 68 69 70 71 72 73 5 



Pc 

:pc| 



78 



1? 
11 
7 8 

52 

i 

r 



1% 
It 



P ATS 



Figure C-l Sales List 



EXAMPLE 2: OVERTIME ANALYSIS 

Input Record Positions 

1-3 Department Number (DEPTNO) 

4-8 Employee Number (EMPNUM) 

9-39 Employee Name (EMPNAM) 

40-43 Standard Number of Working Hours (STDHRS) 

50-53 Total Number of Hours Worked (HOURS) 

80 Plant Identification Code 

This Record Sort produces a record of employees by department number 
in the main plant (M) who incurred overtime. The Record Type 
Specification shows the use of both an Include and an Omit line; with 
a field and a constant Factor 2 comparison. 
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SORT PROGRAM EXAMPLES 



EQUIPMENT 
CORPORATION 



Oste . 
Progri 



SORT SPECIFICATIONS 

HEADER SPECIFICATION 



1 2 



> tam |_L_ 
itification |Q[T 



75 76 77 78 79 80 



AM \H J. 



Lin. , 
F 

3 4 5 


Mode of Processing 


Total 
Length of 
Key Fields 

13 H 15 16 1' 


- 

! NOT USED 

\ 

1 19 20 ?i 22 ?3 ?4 ?S 


X 

a 

C7 


U 

< 

?6 




SORTR.T 


Comments 

(Program Identification) 

33 34 35 36 11 38 39 40 41 4? 43 44 45 46 4/ 48 49 SO SI 52 $3 54 5b S6 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 


c SORTR 
. SORTT 
i SORTA 
SORTI 

7 « 9 10 H 1? 


|S NOT USED 


[ Output 
3 Record 
5 Lengih 

8 ?S JO U 3? 


| [ I- 


s|o|r|t|«| 


1 1 I'la' 


• 






1 Wt 





RECORD TYPE SPECIFICATION 



Line 
3 4 S 


| » Type I/O | 


| - Continuation A/O | 


|» C/Z/O/P/B/F J 


Factor 1 


EQ 
Nfc 
GT 
GE 
LT 
LE 

w it 


Factor 2 


Record Name j 

40 41 4? 43 44 45 46 « I U» 49 SO 51 52 S3 54 55 56 57 5! 59 60 61 62 63 64 65 66 67 61 69 70 71 72 73 74 


Field Location 


'9 


— Con 

Field Location ~" ] 


slant •» 

29 J0 31 3? 33 34 35 36 37 38 39' 


From 

9 10 11 12 


To 

11 14 15 16 


From 

20 21 22 23 


To | 

24 ?5 26 ?>t?8 


□ 






O 




P 






5 













L 


c 


F 






It 








•> 


























H 





o 


« 


a 













3 






e 


X 


c 


E 


e 


J> 




S 


r 


A 


•* 




A 























2 




z 




C 


















e 


a 


C 


1 


























L 


o 


c 




T 


r 


o 




« 


A 


E 






c 


l_ 


A 


N 


r 




o 


rv 


u 


y 





























3 































































































































4 















































































































































5 



























































































































6 





































































































































FIELD SPECIFICATION 



Line 
3 4 5 


S 
6 


O 

g 
z 


| » C/Z/D/P/B/F | 


Field Location 


Forced 


NOT USED 

20 21 ?2 21 24 25 26 71 ?8 ?9 30 31 3? 11 34 35 36 37 38 39 


| Comments 




| £ Compare Char | 




From 

9 10 H 12 


To 

13 14 15 16 


Field Name 


46 4 ' 48 49 50 SI 5? S3 54 55 56 S? 58 59 60 61 62 63 64 65 66 6? 68 69 70 7| 72 73 74 





7 




F 


ti 


P 








1 








3 
















































i> 


e 




r 


H 


O 































































8 




F 


o 


P 






s 


? 






5 


3 








































H 


o 


o 




& 






























































□ 


9 




F 


w 










«+ 








8 






















E 


m 


e 


nf 


L) 


T) 


























































1 







F 


p 


c 








9 
o 






3 


<7 


































E 


•n 


f 


ri 




10 




























































1 


1 




F 


J> 


? 














3 


















S 


r 


> 


H 


(? 


3 




























































1 


2 
3 




F 
F 












































































































































F 



































































Figure C-2 Overtime Analysis 



EXAMPLE 3: EMPLOYEE LIST 

This Tag Sort illustrates the use of forced key field specifications. 
The sort is based on the plant identification code in column 80 of the 
input records. In order to sort them in the order M, W, P, the M in 
column 80 is forced to a 1, the W is forced to a 2, and the P is 
forced to a 3. The output record entry is unchanged. 
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SORT PROGRAM EXAMPLES 



EQUIPMENT 
CORPORATION 



Date . 
Progra 



SORT SPECIFICATIONS 

HEADER SPECIFICATION 



75 76 77 78 79 



p a9 e rr;r„,o n |eH» HsH 







Mode of Processing 












SORTR.T 






I 


SORTR 
SORTT 
SORTA 
SORTI 

' 8 9 10 11 1? 


Total 

Key Fields 




NOT USED 




Q 


Z 


o 


Output 

Recoil! 


Comments 


3 4 5 










< 




o 




ii 34 35 ib H 18 il 40 41 4? 43 44 ib 46 H 48 4<) 50 5i 52 S3 54 $5 56 5' 58 59 60 61 62 63 64 65 66 6? 68 69 70 71 72 73 74 


| | 




s|o|r|t|t| 


1 I &L 


A 








X 


! W 


E |.kNo|v| e |el IJdsH 1 ! M 1 ! 1 ! ! M ! I 1 1 I 1 I 1 1 I I 1 1 ! 1 II 



RECORD TYPE SPECIFICATION 



Line 




g 

< 




Factor 1 


EQ 
















FriCtO 


2 






















Type I/O 


















Nfc 
















- Consta 
1 


























/Z/D/P 


Field Location 


GT 
GE 
LT 




Field Location 
















— 1 
1 




Comments 










Fr 








To 


LE 






Fi 








To 


















Hec 


orri M 




1 






3 4 S 


































































70 71 72 73 74 



















































- 































































































2 
































































... 















































































3 


















































































r 







































































































- 

































































































5 

















































































































































6 
















































i 


i 

























































































FIELD SPECIFICATION 



1 

Fieki Njme | 



I 55 56 5> 58 59 60 61 62 63 64 65 66 6 ' 68 69 70 71 



PC 



52 



80 



ttr 

! II 



t t 



ft 



AS : 



Figure C-3 Employee List 
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APPENDIX D 
RMS I/O STATUS CODES 



This appendix describes I/O status codes that can be returned by RMS. 

For some error conditions, RMS uses the RMS-status-code field of the 
SORT error message to communicate additional information. Table D-l 
lists the RMS status codes and what they mean. 



Table D-l 
RMS Error Status Codes 



Decimal 
Value 


Description 


-16 


Operation aborted: out— of— stack save area or in— core data 
structures corrupted. 


-32 


ACP could not access the file. 


-48 


File activity precludes action (e.g., attempting to close a 
file with outstanding asynchronous record operation) . 


-64 


Bad area identification number (AID) field in allocation XAB 
(i.e., out of sequence). 


-80 


Illegal value in alignment boundary type (ALN) field of 
allocation XAB. 


-96 


Value in allocation quantity (ALQ) field in FAB (or 
allocation XAB) exceeds maximum or, during an explicit 
$EXTEND operation, equals 0. 


-112 


Records in a file on ANSI-labeled magnetic tape are variable 
length but not in ANSI D format. 


-128 


Illegal value in allocation options (AOP) field in 
allocation XAB. 


-144 


Invalid operation at AST level: attempting to issue a 
synchronous operation from an asynchronous record operation 
completion routine. 


-160 


Read error on file header attributes. 


-176 


Write error on file header attributes. 


(Continued on next page) 
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RMS I/O STATUS CODES 



Table D-l (Cont.) 
RMS Error Status Codes 



Decimal 
Value 


Description 


-192 


Bucket size (BKS) field in FAB contains value exceeding 
maximum. 


-208 


Bucket size (BKZ) field in allocation XAB contains value 
exceeding maximum. 


-224 


Block length (BLN) field in a FAB or RAB is incorrect. 


-232 


Beginning of file detected on $SPACE operation to magnetic 
tape file. 


-240 


Private buffer pool address not a double word boundary. 


-256 


Private buffer pool size not a multiple of 4. 


-272 


Internal error detected in RMS-11; no recovery possible; 
contact a Software Specialist. 


-288 


Cannot connect RAB (i.e., only one record access stream 
permitted for sequential files) . 


-304 


$UPDATE attempting to change a key field that does not have 
the change attribute. 


-320 


Index file bucket check-byte mismatch. The bucket has been 
corrupted. No recovery possible for the bucket. 


-352 


Invalid COD field in XAB or this XAB type is illegal for the 
organization or operation. 


-368 


ACP could not create file. 


-384 


No current record: operation not immediately preceded by a 
successful $GET or $FIND . 


-400 


ACP deaccess error during $CLOSE. 


-416 


Invalid area number in DAN field of key definition XAB. 


-448 


1. Syntax error in device name. 

2. No such device. 

3. Inappropriate device for operation (e.g., attempting to 
create an indexed file on magnetic tape) . 


-464 


Syntax error in directory name. 


-480 


Dynamic memory exhausted: insufficient space in central 
space pool or private buffer pool. 




(Continued on next page) 
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RMS I/O STATUS CODES 



Table D-l (Cont.) 
RMS Error Status Codes 



Decimal 
Value 


Description 


-496 


Directory not found. 




-512 


Device not ready. 




-520 


Device positioning error. 




-544 


Duplicate key detected, duplicates allowed attribute not 
for one or more key fields. 


set 


-560 


ACP enter function failed. 




-576 


Environment error; operation not selected in ORG$ macro. 




-592 


End of file. 




-608 


Expanded string area in NAM block too short. 




-616 


File expiration date not reached. 




-624 


File extend failure. 




-640 


Not a valid FAB: BID field does not contain FB$BID. 




-656 


1. Record operation attempted was not declared in FAC field 
of FAB at open time. 

2. Invalid contents in FAC field. 

3. FB$PUT not present in FAC for $ CREATE operation. 


-672 


File already exists (attempted $CREATE operation) . 




-680 


Invalid file ID. 




-688 


Invalid combination of values in FLG field of key definition 
XAB (e.g., no duplicates and keys can change). 


-704 


File locked by another user — your program cannot access 
the file because its sharing specification cannot be met. 


-720 


ACP Find function failed. 




-736 


File not found. 




-752 


Syntax error in file name. 




-768 


Invalid file options. 




-784 


Device full: cannot create or extend file. 




-800 


Invalid area number in IAN field of key definition XAB. 




-816 


Index not initialized (this code can only occur in the 
field when STS contains ER$RNF) . 


STV 



(Continued on next page) 
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Table D-l (Cont.) 
RMS Error Status Codes 



Decimal 
Value 


Description 


-832 


Invalid IFI field in FAB . 


-848 


Maximum number (254) of key definition or allocation XABs 
exceeded or multiple summary, protection, or date XABs 
present during operation. 


-864 


$INIT or $INITIF macro call never issued. 


-880 


Illegal operation; examples include: 

1. Attempting a $TRUNCATE operation to a non-sequential 
file. 

2. Attempting an $ERASE or $EXTEND operation to a magnetic 
tape file. 

3. Issuing a block mode operation (e.g., $READ or $WRITE) 
to a stream not connected for block operations. 

4. Issuing a record operation (e.g., $GET, $PUT) to a 
stream connected for block mode operations. 


-896 


Illegal record encountered in sequential file: invalid 
count field. 


-912 


Invalid internal stream identifier (ISI) field in RAB (field 
may have been altered by user) or $CONNECT never issued for 
stream. 


-928 


Key buffer address (KBF) field equals 0. 


-944 


Record identifier (i.e., the 4-byte location addressed by 
KBF) for random operation to relative file is or negative. 


-960 


Invalid key of reference (KRF) in RAB: 

1. As input to random $GET or $FIND operation, or 

2. As input to $CONNECT or $ REWIND (in this case, ER$KRF is 
returned for the first record operation following the 
$C0NNECT or $ REWIND) . 


-976 


Key size equals or too large (indexed file) or not equal 
to 4 (relative file) . 


-992 


Invalid area number in LAN field of key definition XAB. 


-1008 


Magnetic tape is not ANSI labeled. 


-1024 


Logical channel busy. 


-1040 


Invalid value in logical channel number (LCH) field of FAB. 


-1048 


Attempt to extend an area containing an unused extent. 


-1056 


Invalid value in LOC field of allocation XAB. 
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Table D-l (Cont.) 
RMS Error Status Codes 



Hap 1 TT1 A 1 

Value 


Descr iotion 


-1072 


In-core data structures (e.g., I/O buffers) corrupted (this 
code can only occur in the STV field when STS contains 
ER$ABO) . 


-1088 


ACP could not mark file for deletion. 


-1104 


1. Maximum record number field contains a negative value 
during $ CREATE of relative file. 

2. Record identifier (pointed to by KBF) for random 
operation to relative file exceeds maximum record number 
specified when file created. 


-1120 


Maximum record size (MRS) field contains during $CREATE 
operation and: 

1. Record Format is fixed, or 

2. File organization is relative. 


-1136 


Odd address in Name Block address (NAM) field in FAB on 
$OPEN, $CREATE, or $ERASE. 


-1152 


Not at end-of-file: attempting a $PUT operation to a 
sequential file when stream is not positioned to EOF. 


-1168 


Cannot allocate internal index descriptor: insufficient 
room in space pool while attempting to open an indexed file. 


-1184 


Hn nrinifli'v flpfini'fion Y AR nrp<;pnt" Hur i nn S PRPA TP o f 

Dl\J 1_ X 1 LI CI I- V !\C?jr UC J. lilX LXUH AnD Ul. CoCil L LI U 1 X 1 1 y ipt X\ Xj n J. Hi KJ JL 

indexed file. 


-1216 


XABs in chain not in correct order: 

1 Allocation or kp>v dpf i n i H on yarc not" in aif pnd i na for 

densely ascending) order. 
2. XAB of another type intervenes in key definition or 

allocation XAB sub-chain. 


-1232 


Invalid value in file organization (ORG) field of FAB. 


-1248 


Error in file prologue: file is corrupted and must be 
reconstructed . 


-1264 


Key position (POS) field in key definition XAB contains a 
value exceeding maximum record size. 


-1280 


File header contains bad date and time information 
(retrieved by RMS-11 because a date and time XAB is present 
during a $OPEN or $DISPLAY operation) ; file may be 
corrupted . 
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Table D-l (Cont.) 
RMS Error Status Codes 



Decimal 
Value 


Descr iption 


-1296 


Privilege violation: access to the file denied by the 
operating system. 


-1312 


Not a valid RAB: BID field does not contain RB $ B I D . Refer 
to Section A. 3 of this Appendix. 


-1328 


1. Illegal values in record access mode (RAC) field of RAB. 

2. Illogical value in RAC field (e.g., RB$KEY with a 
sequential file) . 


-1344 


1. Illegal values in record attributes (RAT) field of FAB 
during $CREATE. 

2. Illogical combination of attributes (e.g., FB$CR and 
FB$FTN) in RAC field during $CREATE. 


-1360 


Record address (RBF) field in RAB contains an odd address 
(block mode access only) . 


-1376 


File read error. 


-1392 


Record already exists: during a $PUT operation in random 
mode to a relative file, an existing record found in the 
target record position. 


-1408 


Invalid RFA in RFA field of RAB during RFA access. 


-1424 


1. Invalid record format in RFM field of FAB during 
$CREATE. 

2. Specified record format is illegal for file 
organization . 


-1440 


Target bucket locked by another task or another stream in 
the same program. 


-1456 


ACP Remove function failed. 


-1472 


Record identified by KBF/KSZ fields of RAB for random $GET 
or $FIND operation does not exist in relative or indexed 
file (for indexed files only, STV may contain ER$IDX) . 
Record may never have been written or may have been deleted. 


-1488 


$FREE operation issued but no bucket was locked by stream. 


-1504 


Record options (ROP) field contains illegal values or 
illogical combination of values. 


-1520 


Error while reading prologue. 


-1536 


Invalid PRV record encountered in indexed file; file may be 
corrupted . 


-1552 


Record stream active, i.e., in asynchronous environment, 
attempting to issue a record operation to a stream that has 
a request outstanding. 
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Table D-l (Cont.) 
RMS Error Status Codes 



Decimal 
Value 


Description 


-1568 


Record size specified in RSZ of RAB during $PUT or $UPDATE 
is invalid: 

1. RSZ equals 0. 

2. RSZ exceeds maximum record size (MRS) specified when 
file created. 

3. RSZ not equal to size of Current Record for $UPDATE 
operation to a sequential file on disk. 

4. RSZ does not equal MRS (for fixed format records). 


-1584 


Record too big for your buffer: RMS-11 could not move 
entire record retrieved by $GET operation to work area 
(UBF/USZ) . Note that this error does not destroy the 
current context of the stream. Rather, the stream's context 
is updated as if the operation had been completely 
successful . 


-1600 


During $PUT operation, key of record to be written is not 
equal to or greater than key of previous record (and RAC 
field contains RB$SEQ) . 


-1616 


Illogical value in SHR field of FAB (e.g., FB$WRI specified 
for sequential file) . 


-1632 


Invalid SIZ field in key definition XAB during $CREATE 
(e.g., specified size exceeds maximum record size). 


-1648 


During asynchronous record operation, RMS-11 has found that 
the stack is too big to be saved (this code can only occur 
in the STV field when STS contains ER$ABO) . 


-1664 


System directive error. 


-1680 


Index tree error: indexed file is corrupted. 


-1696 


Syntax error in file type (e.g., more than three characters 
specified) . 


-1712 


Invalid address in UBF field of RAB: 

1. UBF contains 0, or 

2. UBF not word aligned (for block mode access only) . 


-1728 


Invalid USZ field in RAB (i.e., USZ contains 0). 


-1744 


Syntax error in file version number. 


-1760 


Invalid VOL field in allocation XAB (i.e., VOL does not 
contain 0) . 


-1776 


File write error. 


-1784 


Device is write locked. 


-1792 


Error while writing prologue. 


-1808 


XAB field in FAB (or NXT field in XAB) contains an odd 
address. 
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Alphanumeric Characters - the numbers and letters contained in the 
ASCII character set. 

ASCII Character Set - the set of 128 seven-bit American Standard Code 
for Information Interchange characters (see Appendix A) . 

Byte - the smallest addressable unit of information; eight bits. 
Each ASCII character usually resides in a single byte. 

Collating Sequence - the order into which characters are sorted based 
upon numeric values assigned to each. 

Device - any of the peripherals referenced by the operating system. 

Digit - in EBCDIC representation, the numeric value of the low-order 
four bits of a byte. 

EBCDIC - an alternate character set used widely in the computing 
industry (see Table A-2 for comparison with ASCII characters) . 

Field - a logically distinguishable area within a record in which data 
is located. 

File - a collection of related records treated as a unit. 

Floating-Point Binary - a method for storing numeric data, the 
exponent occupies the first byte and the mantissa resides in the next 
three or seven bytes. 

Format - the arrangement of any record or file; the order in which 
fields reside in a record. 

Key, Key Field - the sorting key is the data element chosen from a 
record to control the sort. For example, if a list of names is sorted 
alphabetically, the keys would be each successive letter in the name 
field. 

Key, Major - the most important field in the total key. If you were 
sorting a list by name, department and salary, name would be the major 
key. 

Key, Minor - the least significant field in the total key. In the 
example above, salary is the minor key. 

Line - In this document, a line generally refers to a line in the SORT 
specifications form or a record on the specification file. 

Packed Decimal - method for compact storage of numeric data; two 
digits are stored in each 8-bit byte and the sign resides in the last 
byte of the low-order digit. 



Glossary-1 



RMS - Record Management Services 

Record - the unit of information in a file; a group of related fields 
treated as a unit 

System Device - the device on which the Executive resides. 
Word - two bytes or sixteen bits of data 

Work File - a collection of sorted records created during the 
processing cycle and released after the sort is finished 

Zone - the top three punches of a character as represented on a punch 
card or the numeric value of the upper four bits of a byte 
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Allocation, 
file, 5-1 
Allocation switch, 3-1 
Alternate collating sequence, 

1-6, 3-6 
Alternate key, 1-2 
ALTSEQ, 1-6, 3-6 
ALTSEQ format and notes, 3-10 
ALTSEQ records, 3-6 
ANSI format, 1-3 
Ascending order, 1-4 
ASCII character set, table, A-2 
ASCII data, 1-2 
ASCII zone, 3-4 
Available internal storage 

space, 1-8 



Binary data, 1-2 
Block, 

512-byte, 3-1 
Blocks per bucket, 3-1 
Blocksize switch, 3-1 
Boolean expression, 3-12 
Bucket , 

blocks per, 3-1 
Bucket size, 3-1 
Bucketsize switch, 3-1 



Changing SORT defaults, 3-1 
Changing sort order within 

a sequence, 3-6 
Character set, table, 

ASCII, A-2 

EBCDIC, A- 3 
Characters, equal digits, 

printable, table, B-2 
Characters, equal zones, 

printable, table, B-3 



Code, 

device, 2-3 

user identification, 2-3 
Codes , 

RMS error, 4-6 

RMS error status, D-l 
Codes , table , 

device specification, 2-4 
Collating sequence, 

alternate, 1-6, 3-6 

normal, 1-5 
Collation, 

nonstandard, 3-5 
Command decoder errors, 4-1 
Command file, 

indirect, 2-2 
Command string, 1-1, 1-4, 2-2 

errors, 1-7 

format, 2-1, 2-2 

functions, 1-4 

SORT, 2-1 

switches, 2-2 
Comments, 3-7 
Conditional keys, 3-16 
Conditions, 

error, 4-1 
Configuration , 

system, 1-2 
Contiguous switch, 3-2 
Control fields, 1-1 
Control program, 1-7 

errors, 4-6 
Control-phase, 4-1 
Controlling SORT, 1-1 
Controlling SORT options, 3-1 
Controls, 

sorting process, 3-5 
Conventions , 

file naming, 5-1 



Data, 

ASCII, 1-2 

binary, 1-2 

EBCDIC, 1-2 

field, 1-2 

defining, 3-6 
locating, 3-6 
specifications, 3-6 

handling, 3-4 

irrelevant to SORT, 1-2 

key, 1-2 

output, 1-9 

relevant, 1-2 

restricted- format key, 3-6 
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Data base, 1-1 
Decoder errors, 

command, 4-1 
Defaults, 

changing SORT, 3-1 

file, footnote, 3-2 

file types, 2-3 

sort process, 1-8 

switch, table, 3-2 
Defining a data field, 3-6 
Defining a key, 3-7 
Description sequence, 

field, 3-3 
Device , 

code, 2-3 

file, input and output, 2-2 
peripheral, 1-2 
specification codes, table, 

2- 4 
switch, 3-2 
types, table, 2-4 

Different record formats, 1-7 
Digits, 

printable characters, 
equal, B-2 
Direct access from a random 

file, 1-1 
Directing SORT, 1-5 
Discussion, 

specification file example, 

3- 16 
Disk, 1-2 

scratch files on, 1-8 
wasted space on, 5-2 



EBCDIC, 

character set, table, A- 3 

data, 1-2 
Entry, 

common, of specification 

lines, 3-6 
field specification, 3-14 
header specification, 3-8 

notes, 3-9 
record type specification, 

3-16 

SORT specification, figure, 

3-17 
Error , 
codes, 

RMS, 4-6 

RMS status, D-l 
command decoder, 4-1 
command string, 1-7 
control program, 4-6 
I/O, 4-1, 4-5 
merge, 4-6 



Error (Cont. ) , 
messages, 4-1 
other, 4-6 
presort, 4-6 
SORT, 4-1 

specification file, 1-8, 
4-1, 4-3 
Example , 
SORT, C-l 
SORTR, 3-16 

specification file discussion, 
3-16 
Expression, 
Boolean, 3-12 



Field, 

control, 1-1 
data, 1-2 

defining a data, 3-6 
description sequence, 3-3 
first byte, key, 3-3 
interpretation, 1-2 
key, 1-1, 1-5, 3-3 
length, key, 3-3 
locating a data, 3-7 
location, key, 1-5 
specification, 3-6, 3-14 

data, 3-6 

entries, 3-15 

key, 3-6 

notes, 3-15 

stripping key, 3-14 

table, 3-21 
File, 

allocation, 5-1 
defaults, footnote, 3-2 
devices, 

input and output, 2-2 
errors , 

specification, 1-8, 4-1, 
4-3 

example, discussion, 
specification, 3-16 

index, 1-1 

indexed, 1-2 

indirect command, 2-2 

information, 
RMS, 1-5 

input, 1-1, 1-9, 2-2, 3-16, 
5-1 

input and output, 3-1 
internal work, 1-4 
merging scratch, 1-8 
moving records within a, 

3-6 
name, 2-3 
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File (Cont. ) , 

naming conventions, 5-1 
needed, number of scratch, 

1- 8 

on disk, scratch, 1-8 
opening the input, 1-8 
optional specification, 1-1 
organization , 

input, 3-1 

RMS-valid, 1-2 
output, 1-8, 2-1, 2-2, 3-6, 

5-1 

parameters, 1-4 

random, direct access, 1-1 

relative, 1-1 

scratch, 5-2 

sequential, 1-1 

sequential access from a 

random, 1-1 
sorted, 2-1 

specification, 1-4, 1-8, 

2- 2, 2-3, 3-5, 3-14, 

3- 16, 4-3, 5-1 
structure, scratch, 5-2 
switch, 3-3 

type, 2-3 

types, default, 2-3 

uniform format input, 1-4 

usage, scratch, 5-3 
First byte, 

key field, 3-4 
FIXED format, 3-3 
FIXED records, 1-8 
Forced keys, 1-6 
Form, 

SORT specification, 3-7 
Format, 

ALTSEQ, and notes, 3-10 
ANSI, 1-3 

command string, 2-1, 2-2 

FIXED, 3-3 

output, 1-7 

packed decimal, 3-4 

record, 1-5 

different, 1-7 
STREAM, 3-3 
switch, 3-3 

uniform input file, 1-4 
UNKNOWN, 3-3 
VARIABLE, 3-3 
variable record, 3-6 
variation, input, 1-7 
Functions , 

command string, 1-4 



General data, irrelevant to 
SORT, 1-2 



Handling, 

data, 3-4 
Header specification, 3-6, 
3-17 

entries, 3-9 

notes, 3-9 

table, 3-18 
High-speed sorting, 1-9 



I/O errors, 4-1, 4-5 
Identification by type, 

record, 1-7 
Identification code, 

user, 2-3 
Identifier, 

record, 1-2 
Index , 

file, 1-1 

record, 1-1 

sort, 1-1, 1-8 
Indexed file, 1-2 
Indexed sequential switch, 
3-3 

Indirect command file, 2-2 
Information, 

key, 1-1 

prologue, 1-2 

RMS file, 1-4 

storage of sorted, 1-1 
Initial sorting process, 1-8 
Input and output files, 3-1 

devices, 2-3 
Input file, 1-1, 1-9, 2-2, 
3-16, 5-1 

organization, 3-1 

uniform format, 1-4 
Input format variation, 1-7 
Interactive mode, 2-1 
Internal operations, 

SORT, 5-1 
Internal work files, 1-4 
Interpretation , 

field, 1-2 
Invoking SORT, 2-1 
Irrelevant to SORT, 

general data, 1-2 



Key, 

alternate, 1-2 
conditional, 3-16 
data, 1-2 

restricted- format , 3-6 
defining, 3-7 
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Key (Cont. ) , 

fields, 1-1, 1-5, 3-3 

first byte, 3-3 

length, 3-3 

location, 1-5 

specifications, 3-6 

stripping, 3-14 
forced, 1-6 

specification entries, 3-16 
information, 1-1 
locating a, 3-6 
primary, 1-2 
significance , 

sort, 1-4 
switch, 3-3 



Length , 

key field, 3-3 . 
Line number, 3-7 
Lines , 

common entries of 
specification, 3-7 
Locating a data field, 3-6 
Locating a key, 3-6 
Location, 

key field, 1-5 



Magtape, 1-2, 3-1 
Management Services, 

Record, 1-1, 1-8 
Maximum record size switch, 
1-5 

Merge errors, 4-6 

Merge phase, 1-8 

Merging scratch files, 1-8 

Messages 

SORT error, 4-1 
Method , 

sorting, 1-1 
Mode , 

interactive, 2-1 
Moving records within a file, 
3-6 



Naming conventions, 

file, 5-1 
Nonstandard collation, 3-5 
Normal collating sequence, 1-6 
Notes, 

ALTSEQ format and, 3-10 
field specification, 3-15 
record type specifications, 
3-12 



Null records, 3-16 
Number, 

line, 3-7 

page, 3-7 
Number of scratch files 
needed, 1-8 



Opening the input file, 1-8 
Operations, 
SORT, 3-8 

SORT internal, 5-1 

Optimization, 
sort, 5-1 

Optional specification file, 
1-1 

Options, 

controlling SORT, 3-1 
sort processing, 1-8 
sorting process, 1-5 
sorting process, table, 
1-9 

Order, 1-3 

ascending, 1-3 
ascending sort, 3-4 
descending sort, 3-4 
general sort, 3-4 

Organization, 
input file, 3-1 

Organization, RMS-valid, 
file, 1-2 

Other errors, 4-6, 4-8 

Output data, 1-9 

Output file, 1-8, 2-1, 2-2, 
3-7 

devices, 2-2 

parameters, 2-2, 3-1, 5-1 
Output format variation, 1-7 
Output record, 1-11, 3-14 
Output switch, 3-4 



Packed decimal format, 3-4 
Page number, 3-7 
Parameters , 
file, 1-4 

input and output file, 2-1 

SORT, 3-3 
Parts of SORT, 1-7 
Peripheral device, 1-2 
Phase, 

merge, 1-8 

SORT, 1-7 
Pointer , 

record, 1-2 
Preallocation problems, 5-1 
Presort errors, 4-6 
Presort operation, 1-8 
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Primary key, 1-2 

Printable characters, equal 

digits, table, B-2 
Printable characters, equal 

zones, table, B-3 
Printer, 1-3 
Problems , 

preallocation, 5-1 
Process, 

controls, sorting, 3-5 

default sort, 1-8 

initial sorting, 1-8 

options, 1-5 
table, 1-9 

SORT, 1-8 

sorting, 1-4, 1-9 

switch, 3-4 
Processing, 

options, sort, 1-8 
Program, control, 1-7 

errors, 4-6 
Prologue information, 1-2 
Prompt , 

SORT, 2-1 



Random file, 

direct access from a, 1-1 
sequential access from a, 
1-1 

Record Management Services, 

1-1, 1-8 
Records, 

ALTSEQ, 3-6 
FIXED, 1-8 
format, 

different, 1-7 

switch, 1-5 

variable, 3-6 
identification by type, 1-7 
identifier, 1-2 
index, 1-1 

moving, within a file, 3-6 

null, 3-17 

output, 3-14 

pointer, 1-2 

selection, 1-5, 3-6 

size switch, maximum, 1-5 

sort, 1-1, 1-8 

sorted, 2-1 

STREAM ASCII, 1-8 

strings of sorted, 1-8 

type specifications, 3-6 

entries, 3-10 

notes, 3-12 

table, 3-19 
VARIABLE length, 1-8 
within a file, moving, 3-6 



Relative file, 1-2 
Relative switch, 3-5 
Relevant data, 1-2 
Restricted- format key data, 
3-6 

RMS, 1-1, 1-8, 3-1 

error codes, 4-6 

error status codes, D-l 

file information, 1*5 
RMS- valid, 

file organization, 1-1 



Scratch files, 5-2 

merging, 1*8 

needed, number of, 1-8 

on disk, 1-8 

structure, 5-2 

usage, 5-3 
Selection, 

record, 1-5, 3-6 
Sequence , 

alternate collating , 1-6 , 
3-6 

changing sort order within 
a, 3-6 

field description, 3-3 

normal collating, 1*5 
Sequential , 

access from a random file, 
1-1 

file, 1-2 

switch, 3-5 
Significance, 

sort key, 1-4 
Size, 

bucket, 3-1 
Size switch, 

maximum record, 1-5, 3-5 
SORT, 1-1, 1-4, 1-8, 2-1, 
3-16, 5-1 

address routing, 1-1, 3-4 

command string, 2-1 

controlling, 1-1 

defaults, changing, 3*1 

directing, 1-5 

error messages, 4-1 

errors, 4-1 

examples, C-l 

general data, irrelevant to, 

1-2 
Index, 1-1 

index, 1-8, 1-10, 1-11, 3-4 
internal operations, 5-1 
invoking, 2-1 
key significance, 1-4 
operations, 3-8 
optimization, 5-1 
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SORT (Cont. ) , 

options, controlling, 3-1 
order, 

ascending, 3-4 
descending, 3-4 
general, 3-4 
within a sequence, 
changing, 3-6 
parameters, 3-3 
parts of, 1-7 
phases, 1-7 
process, 1-8 

default, 1-8 
processes, 1-8 
processing, 

options, 1-8 
Record, 1-1 
record, 1-8 
running, 2-1 
specification, 

entries, figure, 3-18 
form, 3-6 
figure, 3-7 
switches , 3-1 
Tag, 1-1, 1-8, 1-9, 3-4 
Sorted file, 2-1 
Sorted information, 

storage of, 1-1 
Sorted records, 2-1 

strings of, 1-8 
Sorting, 

high-speed, 1-9 
method, 1-1 
process, 1-4, 1-9 
controls, 3-5 
initial, 1-8 
options, 1-5 
table, 1-9 
SORTR, 1-1, 1-8, 3-14 

example, 3-16 
SORTT, 1-1, 1-9, 3-14 
Space, 

available internal storage, 
1-8 

Space on disk, 
wasted, 5-1 
Specification , 

device codes, table, 2-3 
entries, 

field, 3-14 

notes, 3-15 
header, 3-8 
notes, header, 3-9 
record type, 3-10 
SORT, figure, 3-17 
field, 3-6, 3-14 
file, 1-5, 1-8, 2-2, 2-3, 3-5, 
3-14, 3-17, 4-3, 5-1 
errors, 1-8, 4-1, 4-3 



Specification (Cont.), 
file (Cont.), 

example, discussion, 3-16 

optional, 1-1 

switch., 3-3 
form, SORT, 3-7 
header, 3-6, 3-17 
key field, 3-6 

lines, common entries of, 3-7 
record type, 3-6 

notes, 3-12 
table, 

field, 3-22 
header, 3-18 
record type, 3-19 
type, 3-7 
SRT, 2-1 
Status codes, 

RMS error, D-l 
Storage of sorted information, 
1-1 

Storage space, 

available internal, 1-8 
STREAM ASCII records, 1-8 
STREAM format, 3-3 
String, 

command, 1-1, 1-4, 2-1 

of sorted records, 1-8 

SORT command, 2-1 
Stripping key fields, 3-14 
Structure , 

scratch file, 5-2 
Subroutine package, 

SORTS, 1-7 
Switch, 

allocation, 3-1 

blocksize, 3-1 

bucketsize, 3-1 

command string, 2-4 

contiguous, 3-2 

defaults, table, 3-2 

device, 3-2 

files, 3-3 

format, 3-3 

indexed sequential, 3-3 
key, 3-4 

maximum record size, 1-4 
process, 3-4 
record format, 1-5 
relative, 3-5 
sequential, 3-5 
SORT, 3-1 

specification, 1-4 
System configuration, 1-2 



Table, see also Table of 
Contents 
EBCDIC character set, A- 3 
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Tag sort, 1-1, 1-8, 1-9, 3-4 
Terminal, 1-2 
Terminators , 

valid, 4-2 
Time, 

elapsed, 2-1 

wall clock, 2-2 
Type, 

file, 2-3 

record identification by, 1-7 
specification, 3-6 
Type specifications, 
record, 3-10 
entries, 3-10 
notes, 3-12 
table, 3-19 
Types , 

default file, 2-4 
Types , table , 
device, 2-4 



Valid terminators, 4-2 

Values , 

switch, 1-7, 3-1 

VARIABLE format, 3-3, 3-6 

VARIABLE length records, 
1-8 

Variation , 

input format, 1-7 
output format, 1-7 



Wall clock time, 2-2 
Wasted space on disk, 5-1 
Work files, 
internal, 1-4 



Uniform format input file, 1-4 
UNKNOWN file format, 3-3 
Usage , 

scratch file, 5-3 



Zone, 

ASCII, 3-4 
Zones , 

printable characters 
equal, table, B-3 
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